Jak wczytać i zapisać dokumenty Word z użyciem strumieni i metod asynchronicznych w C#
IronWord w wersji 2026.10.1+ wprowadza bezpośrednie wczytywanie z i zapisywanie do każdego System.IO.Stream, razem z metodami asynchronicznymi dla obu operacji. Wczytywanie i zapisywanie były wcześniej realizowane przez ścieżki do plików i tablice bajtów. Dokument .docx, który jest przesyłany jako web upload, pochodzi z magazynu blob lub jest zwracany jako odpowiedź HTTP, nigdy nie musi być zapisywany na dysk, więc funkcje bezserwerowe i punkty końcowe web pozostają całkowicie w pamięci.
Trzy punkty wejścia do WordDocument obejmują każdy scenariusz: ścieżka do pliku, kiedy .docx znajduje się na dysku, strumień, kiedy bajty są już przesyłane, i tablica bajtów, kiedy wszystko jest już w pamięci.
Przekaż dowolny strumień do konstruktora WordDocument, a następnie zapisz do innego strumienia, jak w przykładzie wczytywania i zapisywania ze strumieniami.
-
1Zainstaluj IronWord z NuGet Package Manager
-
2Skopiuj i uruchom ten fragment kodu.
using var input = File.OpenRead("source.docx"); var doc = new WordDocument(input); using var output = new MemoryStream(); doc.Save(output);C# -
3Wdrożenie do testowania w środowisku produkcyjnym
Rozpocznij korzystanie z IronWord w swoim projekcie już dziś z darmową wersją próbną
Minimalny proces (5 kroków)
Jakie przeciążenie wczytywania i zapisywania powinienem użyć?
Wybierz przeciążenie odpowiadające lokalizacji danych.
| Metoda | Kierunek | I/O | Asynchroniczne |
|---|---|---|---|
WordDocument(string filePath) | Wczytywanie | Plik | Nie |
WordDocument(byte[] bytes) | Wczytywanie | None | Nie |
WordDocument(Stream stream) | Wczytywanie | Strumień | Nie |
WordDocument.LoadAsync(string, CancellationToken) | Wczytywanie | Plik | Tak |
WordDocument.LoadAsync(Stream, CancellationToken) | Wczytywanie | Strumień | Tak |
Save() zwraca byte[] | Zapisywanie | None | Nie |
Save(string filePath) | Zapisywanie | Plik | Nie |
Save(Stream stream) | Zapisywanie | Strumień | Nie |
SaveAs(string filePath) | Zapisywanie | Plik | Nie |
SaveAsync(string, CancellationToken) | Zapisywanie | Plik | Tak |
SaveAsync(Stream, CancellationToken) | Zapisywanie | Strumień | Tak |
SaveAsAsync(string, CancellationToken) | Zapisywanie | Plik | Tak |
Tablice bajtów są synchroniczne z założenia: konstruowanie z bajtów i serializacja do tablicy bajtów nie wykonują operacji I/O, więc nie ma nic do oczekiwania. Aby utworzyć dokument w całości w pamięci i pobrać go jako bajty, wywołaj byte[] Save().
Zapisywanie wymaga ważnej licencji IronWord, tak samo jak każda inna ścieżka zapisywania.
Co to jest kontrakt strumienia?
Pięć zasad reguluje, jak IronWord traktuje strumień rozmówcy.
- Własność strumienia: IronWord nigdy nie zamyka strumienia rozmówcy, więc rozmówca jest jego właścicielem i usuwa go
- Wczytywanie: czyta od bieżącej pozycji do końca i pozostawia strumień na jego końcu
- Zapisywanie: zapisuje w bieżącej pozycji
- Brak skrócenia: ponownie wykorzystany strumień, który już zawierał dłuższy dokument, zachowuje swoje stare bajty końcowe po nowej treści, a wynik to uszkodzony .docx, więc zresetuj go przy użyciu
SetLength(0)przed zapisywaniem - Nieskrawalne strumienie: obsługiwane zarówno jako źródło, jak i cel, ponieważ żadne wczytywanie ani zapisywanie nie wymaga szukania
using IronWord;
using IronWord.Models;
// Build a document entirely in memory
var doc = new WordDocument();
doc.AddParagraph(new Paragraph(new TextContent("Invoice #1042")));
doc.AddParagraph(new Paragraph(new TextContent("Total: $2,450.00")));
// Save to a MemoryStream
using var ms = new MemoryStream();
doc.Save(ms);
// Reset the position before handing the stream to another consumer
ms.Position = 0;
// Print the document size
Console.WriteLine($"Document size: {ms.Length} bytes");
Jak używać strumieni w ASP.NET Core?
ASP.NET Core: new WordDocument(Request.Body) i doc.Save(Response.Body) wywołują wyjątek w domyśle Kestrela, więc należy użyć LoadAsync i SaveAsync
Jak wygląda przesłany dokument?
Przesyłanie to krótka notka dostawcy z tytułem i dwoma akapitami.

using IronWord;
using IronWord.Models;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;
var app = WebApplication.Create();
// Upload a .docx, append a confidentiality notice, and return the modified document
app.MapPost("/add-notice", async (HttpRequest request) =>
{
// Load the request body asynchronously
var doc = await WordDocument.LoadAsync(request.Body);
// Append a confidentiality notice
doc.AddParagraph(new Paragraph(new TextContent("CONFIDENTIAL")));
// Set the download headers
var response = request.HttpContext.Response;
response.ContentType =
"application/vnd.openxmlformats-officedocument.wordprocessingml.document";
response.Headers.ContentDisposition = "attachment; filename=modified.docx";
// Save to the response body asynchronously
await doc.SaveAsync(response.Body);
return Results.Empty;
});
app.Run();
Co zwraca punkt końcowy?
Punkt końcowy zwraca tę samą notkę z dodanym akapitem CONFIDENTIAL.

Co właściwie robią metody asynchroniczne?
Tylko operacje I/O z plikami lub strumieniami są asynchroniczne i możliwe do anulowania. Parsowanie wczytanego dokumentu i serializacja zapisanego to synchroniczne, uzależnione od CPU kroki, których CancellationToken nie może przerwać. Token jest sprawdzany przed tą pracą i wokół wywołań I/O.
Jak wygląda raport przed zapisaniem?
report.docx zawiera tytuł i dwa akapity.

using IronWord;
using IronWord.Models;
// Load a document from disk asynchronously
var doc = await WordDocument.LoadAsync("report.docx");
// Append a dated paragraph
doc.AddParagraph(new Paragraph(
new TextContent("Appendix added on " + DateTime.Now.ToString("yyyy-MM-dd"))));
// Save to a new path, leaving the original untouched
await doc.SaveAsAsync("report-updated.docx");
Jak wygląda zaktualizowany raport?
report-updated.docx zyskuje datowaną linię dodatku, a report.docx pozostaje niezmieniony.

Czy anulowanie jest bezpieczne dla zapisów plików?
Anulowanie jest bezpieczne tylko wtedy, gdy token jest już anulowany, gdy wywołanie się zaczyna. W takim przypadku zapis na ścieżkę powoduje wyjątek, zanim plik docelowy zostanie otwarty, więc istniejący plik pozostaje nietknięty.
Po rozpoczęciu zapisu: anulowany zapis może pozostawić plik pusty lub częściowo zapisany, z utraconą starą zawartością, a strumień częściowo zapisany
Czy WordDocument jest bezpieczny dla wątków?
Nie. Pojedyncza instancja WordDocument nie jest bezpieczna dla wątków. Nie uruchamiaj operacji zapisu równocześnie na tym samym wystąpieniu: Task.WhenAll(doc.SaveAsync(pathA), doc.SaveAsync(pathB)) powoduje nieokreślone zachowanie.
Najczęściej zadawane pytania
Jak wczytać dokument Word z użyciem strumienia w C# za pomocą IronWord?
Przekaż dowolny strumień do odczytu, taki jak MemoryStream lub przesłany plik, do konstruktora WordDocument. IronWord czyta dokument od bieżącej pozycji strumienia do końca.
Jak mogę zapisać dokument Word do strumienia z IronWord?
Wywołaj metodę Save z użyciem dowolnego strumienia do zapisu, na przykład MemoryStream, aby zapisać dokument bez zapisywania go na dysku. IronWord zapisuje dokument na bieżącej pozycji strumienia.
Czy mogę wczytywać i zapisywać dokumenty Word asynchronicznie w C#?
Tak. IronWord oferuje LoadAsync dla ścieżek plików i strumieni oraz SaveAsync i SaveAsAsync do zapisywania, dzięki czemu kod asynchroniczny nie blokuje wątku na operacje wejścia/wyjścia.
Czy IronWord zamyka strumień po wczytaniu lub zapisaniu dokumentu?
Nie. IronWord nigdy nie zamyka strumienia wywołującego. Aplikacja, która otworzyła strumień, jest jego właścicielem i odpowiada za jego zniszczenie.
Dlaczego zapisany dokument Word jest uszkodzony, gdy ponownie używam strumienia?
Zapis do strumienia, który już zawiera dłuższy dokument, pozostawia stare końcowe bajty na miejscu, co uszkadza wynik. Zresetuj lub przytnij strumień przed ponownym zapisaniem do niego.
Czy CancellationToken może zatrzymać IronWord podczas wczytywania lub zapisywania dokumentu?
Token anuluje tylko operacje wejścia/wyjścia pliku lub strumienia. Parsowanie wczytanego dokumentu i serializacja zapisanego są krokami synchronicznymi, których token nie może przerwać.
Czy istnieje asynchroniczna metoda do wczytywania lub zapisywania tablic bajtów w IronWord?
Nie, z założenia. Wczytywanie z tablicy bajtów i zapisywanie do niej nie wiąże się z operacjami wejścia/wyjścia, dlatego IronWord pozostawia synchroniczny konstruktor tablicy bajtów i metodę Save dla tych przypadków pamięciowych.
Czy WordDocument jest bezpieczny dla wątków w IronWord?
Nie. Pojedyncza instancja WordDocument nie jest bezpieczna dla wątków, więc nie uruchamiaj operacji zapisu jednocześnie na tym samym dokumencie, na przykład z Task.WhenAll.
Czy mogę wczytać dokument Word z przesłania, bez wcześniejszego zapisywania go na dysku?
Tak. Przekaż strumień z przesłania bezpośrednio do konstruktora WordDocument lub LoadAsync, edytuj dokument w pamięci, a następnie zapisz go z powrotem do strumienia, dzięki czemu plik nigdy nie trafi na dysk.
Czy zapisanie dokumentu Word do strumienia wymaga licencji IronWord?
Tak. Zapis do strumienia wymaga ważnej licencji IronWord, tak samo jak zapis do ścieżki pliku lub tablicy bajtów.
Ahmad to full-stack developer z solidnym fundamentem w C#, Pythonie i technologiach webowych. Ma głębokie zainteresowanie tworzeniem skalowalnych rozwiązań oprogramowania i cieszy się badaniem, jak projektowanie i funkcjonalność spotykają się w rzeczywistych aplikacjach.