Wie man Word-Dokumente mit Streams und Async in C# lädt und speichert
IronWord 2026.10.1+ führt das direkte Laden aus und Speichern in jedem System.IO.Stream ein, zusammen mit asynchronen Methoden für beide. Bisher erfolgte das Laden und Speichern über Dateipfade und Byte-Arrays. Ein .docx, das als Web-Upload ankommt, aus dem Blob-Speicher heruntergeladen oder in einer HTTP-Antwort zurückgesandt wird, muss nie die Festplatte berühren, sodass serverlose Funktionen und Web-Endpunkte vollständig im Speicher bleiben.
Drei Einstiegspunkte in WordDocument decken jedes Szenario ab: ein Dateipfad, wenn das .docx auf der Festplatte ist, ein Stream, wenn die Bytes bereits fließen, und ein Byte-Array, wenn alles bereits im Speicher ist.
Geben Sie einen beliebigen lesbaren Stream an den WordDocument Konstruktor weiter und speichern Sie anschließend in einen anderen Stream, wie im Beispiel für Laden und Speichern mit Streams.
-
1Installieren Sie IronWord mit NuGet Package Manager
-
2Kopieren Sie diesen Codeausschnitt und führen Sie ihn aus.
using var input = File.OpenRead("source.docx"); var doc = new WordDocument(input); using var output = new MemoryStream(); doc.Save(output);C# -
3Bereitstellen zum Testen in Ihrer Live-Umgebung
Beginnen Sie noch heute, IronWord in Ihrem Projekt mit einer kostenlosen Testversion zu verwenden
Minimaler Arbeitsablauf (5 Schritte)
- Laden Sie die IronWord C#-Bibliothek von NuGet herunter
- Öffnen oder empfangen Sie einen
Streammit .docx-Bytes - Laden Sie es mit
new WordDocument(stream)oderawait WordDocument.LoadAsync(stream) - Bearbeiten Sie das Dokument – fügen Sie Text, Bilder oder Tabellen hinzu
- Speichern Sie es mit
doc.Save(stream)oderawait doc.SaveAsync(stream)
Welche Lade- und Speichern-Überladung sollte ich verwenden?
Wählen Sie die Überladung, die zu dem Ort passt, an dem sich die Daten befinden.
| Methode | Richtung | I/O | Async |
|---|---|---|---|
WordDocument(string filePath) | Laden | Datei | Nein |
WordDocument(byte[] bytes) | Laden | None | Nein |
WordDocument(Stream stream) | Laden | Stream | Nein |
WordDocument.LoadAsync(string, CancellationToken) | Laden | Datei | Ja |
WordDocument.LoadAsync(Stream, CancellationToken) | Laden | Stream | Ja |
Save() gibt byte[] zurück | Speichern | None | Nein |
Save(string filePath) | Speichern | Datei | Nein |
Save(Stream stream) | Speichern | Stream | Nein |
SaveAs(string filePath) | Speichern | Datei | Nein |
SaveAsync(string, CancellationToken) | Speichern | Datei | Ja |
SaveAsync(Stream, CancellationToken) | Speichern | Stream | Ja |
SaveAsAsync(string, CancellationToken) | Speichern | Datei | Ja |
Byte-Arrays bleiben standardmäßig synchron: Das Konstruieren aus Bytes und das Serialisieren in ein Byte-Array führen zu keinem I/O, daher gibt es nichts zu erwarten. Um ein Dokument vollständig im Speicher zu erstellen und es als Bytes zu erhalten, rufen Sie byte[] Save() auf.
Das Speichern erfordert eine gültige IronWord-Lizenz, genauso wie jeder andere Speicherpfad.
Was ist der Stream-Vertrag?
Fünf Regeln bestimmen, wie IronWord mit einem Stream des Anrufers umgeht.
- Stream-Besitz: IronWord schließt den Stream des Anrufers nie, daher liegt der Besitz und die Entsorgung beim Anrufer
- Laden: liest von der aktuellen Position bis zum Ende und lässt den Stream am Ende
- Speichern: schreibt an der aktuellen Position
- Keine Kürzung: Ein wiederverwendeter Stream, der bereits ein längeres Dokument enthielt, behält seine alten nachfolgenden Bytes nach dem neuen Inhalt, was zu einem beschädigten .docx führt, daher setzen Sie ihn vor dem Speichern mit
SetLength(0)zurück - Nicht-seekbare Streams: werden sowohl als Quelle als auch als Ziel unterstützt, da weder Laden noch Speichern suchen
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");
Wie verwende ich Streams in ASP.NET Core?
ASP.NET Core: new WordDocument(Request.Body) und doc.Save(Response.Body) werfen unter Kestrels Standardbedingungen, daher nutzen Sie LoadAsync und SaveAsync
Wie sieht das hochgeladene Dokument aus?
Der Upload ist ein kurzes Lieferantenmemo mit einem Titel und zwei Absätzen.

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();
Was gibt der Endpunkt zurück?
Der Endpunkt gibt dasselbe Memo zurück, dem ein CONFIDENTIAL Absatz angehängt wurde.

Was machen die Async-Methoden tatsächlich?
Nur das Datei- oder Stream-I/O ist asynchron und abbrechbar. Das Parsen eines geladenen Dokuments und das Serialisieren eines gespeicherten sind synchrone, CPU-gebundene Schritte, die CancellationToken nicht unterbrechen kann. Das Token wird vor dieser Arbeit und rund um die I/O-Aufrufe geprüft.
Wie sieht der Bericht vor dem Speichern aus?
report.docx enthält einen Titel und zwei Absätze.

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");
Wie sieht der aktualisierte Bericht aus?
report-updated.docx erhält die datierte Anhangszeile, und report.docx bleibt unverändert.

Ist die Abbruchoption sicher für Dateispeicherungen?
Abbruch ist nur sicher, wenn das Token bereits abgebrochen ist, wenn der Aufruf beginnt. In diesem Fall wirft ein Pfadspeichern noch vor der Öffnung der Zieldatei, sodass eine vorhandene Datei unangetastet bleibt.
Nach Beginn des Schreibens: eine abgebrochene Speicherung kann die Datei leer oder teilweise beschrieben lassen, wobei ihre alten Inhalte verschwunden sind und ein Stream teilweise geschrieben wird
Ist WordDocument Thread-sicher?
Nein. Eine einzelne WordDocument-Instanz ist nicht thread-sicher. Führen Sie keine Speicheroperationen gleichzeitig auf derselben Instanz durch: Task.WhenAll(doc.SaveAsync(pathA), doc.SaveAsync(pathB)) führt zu undefiniertem Verhalten.
Häufig gestellte Fragen
Wie lade ich ein Word-Dokument aus einem Stream in C# mit IronWord?
Übergeben Sie einen beliebigen lesbaren Stream, wie z.B. einen MemoryStream oder eine hochgeladene Datei, an den WordDocument-Konstruktor. IronWord liest das Dokument vom aktuellen Stand des Streams bis zum Ende.
Wie kann ich ein Word-Dokument mit IronWord in einen Stream speichern?
Rufen Sie Save mit einem beliebigen beschreibbaren Stream, wie z.B. einem MemoryStream, auf, um das Dokument zu schreiben, ohne es auf der Festplatte zu speichern. IronWord schreibt das Dokument am aktuellen Stand des Streams.
Kann ich Word-Dokumente in C# asynchron laden und speichern?
Ja. IronWord bietet LoadAsync für Dateipfade und Streams, sowie SaveAsync und SaveAsAsync für das Speichern, damit asynchrone Anwendungscodes einen Thread bei Datei-I/O nicht blockieren.
Schließt IronWord den Stream nach dem Laden oder Speichern eines Dokuments?
Nein. IronWord schließt den Stream des Aufrufers nie. Die Anwendung, die den Stream geöffnet hat, besitzt ihn und ist für dessen Entsorgung verantwortlich.
Warum ist mein gespeichertes Word-Dokument beschädigt, wenn ich einen Stream wiederverwende?
Das Speichern in einen Stream, der bereits ein längeres Dokument enthält, lässt seine alten nachlaufenden Bytes an Ort und Stelle, was die Ausgabe beschädigt. Setzen Sie den Stream zurück oder kürzen Sie ihn, bevor Sie erneut in ihn speichern.
Kann ein CancellationToken IronWord stoppen, während es ein Dokument lädt oder speichert?
Der Token storniert nur das Datei- oder Stream-I/O. Das Parsen eines geladenen Dokuments und das Serialisieren eines gespeicherten Dokuments sind synchrone Schritte, die der Token nicht unterbrechen kann.
Gibt es eine asynchrone Methode zum Laden oder Speichern von Byte-Arrays in IronWord?
Nein, aus Designgründen. Das Laden aus einem Byte-Array und das Speichern in eines erfordern kein I/O, daher behält IronWord den synchronen Byte-Array-Konstruktor und die Save-Methode für diese speicherinternen Fälle.
Ist ein WordDocument in IronWord thread-sicher?
Nein. Eine einzelne WordDocument-Instanz ist nicht thread-sicher, daher sollten Sie keine Speicheroperationen gleichzeitig auf dasselbe Dokument ausführen, zum Beispiel mit Task.WhenAll.
Kann ich ein Word-Dokument aus einem Upload laden, ohne es vorher auf der Festplatte zu speichern?
Ja. Übergeben Sie den Stream des Uploads direkt an den WordDocument-Konstruktor oder LoadAsync, bearbeiten Sie das Dokument im Speicher und speichern Sie es zurück in einen Stream, sodass die Datei nie die Festplatte berührt.
Erfordert das Speichern eines Word-Dokuments in einen Stream eine IronWord-Lizenz?
Ja. Das Speichern in einen Stream erfordert eine gültige IronWord-Lizenz, genauso wie das Speichern in einen Dateipfad oder ein Byte-Array.
Ahmad ist ein Full-Stack-Entwickler mit einer soliden Grundlage in C#, Python und Webtechnologien. Er hat ein großes Interesse am Aufbau skalierbarer Softwarelösungen und genießt es, zu erkunden, wie Design und Funktionalität in realen Anwendungen aufeinandertreffen.