Jak wczytać i zapisać dokumenty Word z użyciem strumieni i metod asynchronicznych w C#

Ahmad Sohail
Ahmad Sohail
Zaktualizowano: 7 października 2026

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.

Krótki przewodnik: Wczytaj i zapisz dokument Word ze strumienia

Przekaż dowolny strumień do konstruktora WordDocument, a następnie zapisz do innego strumienia, jak w przykładzie wczytywania i zapisywania ze strumieniami.

  1. 1Zainstaluj IronWord z NuGet Package Manager

    PM > Install-Package IronWord

  2. 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#
  3. 3Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij korzystanie z IronWord w swoim projekcie już dziś z darmową wersją próbną
    arrow pointer

Jakie przeciążenie wczytywania i zapisywania powinienem użyć?

Wybierz przeciążenie odpowiadające lokalizacji danych.

MetodaKierunekI/OAsynchroniczne
WordDocument(string filePath)WczytywaniePlikNie
WordDocument(byte[] bytes)WczytywanieNoneNie
WordDocument(Stream stream)WczytywanieStrumieńNie
WordDocument.LoadAsync(string, CancellationToken)WczytywaniePlikTak
WordDocument.LoadAsync(Stream, CancellationToken)WczytywanieStrumieńTak
Save() zwraca byte[]ZapisywanieNoneNie
Save(string filePath)ZapisywaniePlikNie
Save(Stream stream)ZapisywanieStrumieńNie
SaveAs(string filePath)ZapisywaniePlikNie
SaveAsync(string, CancellationToken)ZapisywaniePlikTak
SaveAsync(Stream, CancellationToken)ZapisywanieStrumieńTak
SaveAsAsync(string, CancellationToken)ZapisywaniePlikTak

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.

  1. Własność strumienia: IronWord nigdy nie zamyka strumienia rozmówcy, więc rozmówca jest jego właścicielem i usuwa go
  2. Wczytywanie: czyta od bieżącej pozycji do końca i pozostawia strumień na jego końcu
  3. Zapisywanie: zapisuje w bieżącej pozycji
  4. 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
  5. 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");
C#

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.

Dokument Word zatytułowany Quarterly Vendor Memo z dwoma akapitami, przesłany jako upload do końcowego punktu
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();
C#

Co zwraca punkt końcowy?

Punkt końcowy zwraca tę samą notkę z dodanym akapitem CONFIDENTIAL.

Dokument Word zwrócony przez punkt końcowy pokazujący Quarterly Vendor Memo z dodanym akapitem CONFIDENTIAL na końcu

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.

Dokument Word report.docx zatytułowany Q3 Operations Report z dwoma akapitami, przed asynchronicznym zapisem
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");
C#

Jak wygląda zaktualizowany raport?

report-updated.docx zyskuje datowaną linię dodatku, a report.docx pozostaje niezmieniony.

Dokument Word report-updated.docx pokazujący Q3 Operations Report z dodanym paragrafem Appendixa

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.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 62,392Wersja:2026.11właśnie wydane