ストリームと非同期でWord文書を読み込み、保存する方法 (C#)

Ahmad Sohail
Ahmad Sohail
更新日: 2026年10月7日

IronWord 2026.10.1+では、任意のSystem.IO.Streamからの直接読み込みと保存が、非同期メソッドとともに導入されました。 以前はファイルパスとバイト配列を介して行われていた読み込みと保存。 ウェブのアップロードとして届いた.docx、BLOBストレージから来たもの、またはHTTPレスポンスとして戻ってくるものは、ディスクに触れることなく、サーバーレス関数とウェブエンドポイントが完全にメモリに留まります。

WordDocumentへの3つのエントリーポイントは、すべてのシナリオをカバーします:.docxがディスク上にあるときのファイルパス、バイトがすでに流れているときのストリーム、すべてがすでにメモリにあるときのバイト配列。

クイックスタート:ストリームからWord文書を読み込み、保存

任意の読み取り可能なストリームをWordDocumentコンストラクタに渡し、ストリームを使った読み込みと保存の例のように、別のストリームに保存します。

  1. 1IronWord を NuGet Package Manager でインストールします

    PM > Install-Package IronWord

  2. 2このコード スニペットをコピーして実行します。

    using var input = File.OpenRead("source.docx");
    var doc = new WordDocument(input);
    
    using var output = new MemoryStream();
    doc.Save(output);
    C#
  3. 3実際の環境でテストするためにデプロイする

    今日からご自身のプロジェクトでIronWordを使い始めるには、無料トライアルをお試しください。
    arrow pointer

どの読み込みと保存のオーバーロードを使用するべきですか?

データのある場所に一致するオーバーロードを選択してください。

方法方向I/O非同期
WordDocument(string filePath)読み込みファイルなし
WordDocument(byte[] bytes)読み込みNoneなし
WordDocument(Stream stream)読み込みストリームなし
WordDocument.LoadAsync(string, CancellationToken)読み込みファイルはい
WordDocument.LoadAsync(Stream, CancellationToken)読み込みストリームはい
Save()はbyte[]を返します保存Noneなし
Save(string filePath)保存ファイルなし
Save(Stream stream)保存ストリームなし
SaveAs(string filePath)保存ファイルなし
SaveAsync(string, CancellationToken)保存ファイルはい
SaveAsync(Stream, CancellationToken)保存ストリームはい
SaveAsAsync(string, CancellationToken)保存ファイルはい

バイト配列は設計上同期を維持しています:バイトからの構築とバイト配列へのシリアル化はI/Oを伴わないため、待機するものはありません。 メモリ内で完全にドキュメントを生成し、それをバイトとして取得するには、byte[] Save()を呼び出してください。

保存には有効なIronWordライセンスが必要です。他のすべての保存パスと同じです。

ストリーム契約とは何ですか?

IronWordが呼び出し元のストリームをどのように扱うかを管理する5つのルールがあります。

  1. ストリームの所有権: IronWordは呼び出し元のストリームを閉じることはなく、呼び出し元が所有し、処分します
  2. 読み込み: 現在の位置から終端まで読み込み、ストリームをそのまま終端に残します
  3. 保存: 現在の位置に書き込みます
  4. 非切断: すでに長いドキュメントを持つ再利用されたストリームは、新しいコンテンツの後に古い末尾のバイトを保持し、結果として壊れた.docxになります。そのため、保存する前にSetLength(0)でリセットしてください
  5. 検索不可のストリーム: ソースとターゲットの両方としてサポートされています。読み込みも保存も検索を行わないためです
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#

ASP.NET Coreでストリームをどのように使用しますか?

ASP.NET Core: new WordDocument(Request.Body)とdoc.Save(Response.Body)はKestrelのデフォルトでは発生するため、LoadAsyncとSaveAsyncを使用してください

アップロードされたドキュメントはどのように見えるか?

アップロードはタイトルと2つの段落を持つ短いベンダーメモです。

四半期ベンダーメモというタイトルのWordドキュメントで、2つの段落があり、アップロードとしてエンドポイントに送信される
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#

エンドポイントは何を返しますか?

エンドポイントは、CONFIDENTIAL段落が追加された同じメモを返します。

エンドポイントによって返されるWordドキュメントで、四半期ベンダーメモの末尾にCONFIDENTIAL段落が追加されている

非同期メソッドは実際に何をしますか?

ファイルまたはストリームI/Oのみが非同期でキャンセル可能です。 解析されたロードされたドキュメントと保存されたもののシリアル化は同期、CPU依存のステップであり、CancellationTokenが中断できません。 その作業の前とI/O呼び出しの周りでトークンがチェックされます。

保存前のレポートはどのように見えるか?

report.docx はタイトルと2つの段落を持っています。

Wordドキュメント report.docx がQ3 Operations Reportというタイトルで2つの段落を持ち、非同期保存前の状態です
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#

更新されたレポートはどのように見えるか?

report-updated.docxは日附付き附録行を獲得し、report.docxは変更されません。

Wordドキュメント report-updated.docx がQ3 Operations Reportを示し、段落が追加されたAppendixが付いています

ファイル保存のキャンセルは安全ですか?

キャンセルは、トークンがコールが始まった時点で既にキャンセルされている場合にのみ安全です。 その場合、パス保存は宛先ファイルが開かれる前に発生するため、既存のファイルは触れられません。

書き込みが開始された後: キャンセルされた保存は、ファイルが空か部分的に書き込まれることがあり、古い内容が失われ、ストリームが部分的に書き込まれる可能性があります

WordDocumentはスレッドセーフですか?

いいえ。単一のWordDocumentインスタンスはスレッドセーフではありません。 同じインスタンスに対して保存操作を同時に実行しないでください:Task.WhenAll(doc.SaveAsync(pathA), doc.SaveAsync(pathB))が未定義の動作を引き起こします。

よくある質問

C#でIronWordを使用してストリームからWord文書を読み込む方法は?

MemoryStreamやアップロードされたファイルのような読み取り可能なストリームをWordDocumentのコンストラクタに渡します。IronWordはストリームの現在位置から終端まで文書を読み込みます。

IronWordを使用してWord文書をストリームに保存する方法は?

MemoryStreamのような書き込み可能なストリームを使ってSaveを呼び出すことで、文書をディスクに保存せずに書き込むことができます。IronWordはストリームの現在の位置に文書を書き込みます。

C#でWord文書を非同期に読み込んだり保存したりできますか?

はい。IronWordはファイルパスとストリーム用のLoadAsync、保存用のSaveAsyncおよびSaveAsAsyncを提供しているため、ファイルI/Oでスレッドがブロックされません。

IronWordは文書を読み込んだり保存した後にストリームを閉じますか?

いいえ。IronWordは呼び出し元のストリームを決して閉じません。ストリームを開いたアプリケーションが所有し、それを破棄する責任があります。

ストリームを再利用した時になぜ保存したWord文書が壊れているのですか?

既に長い文書を持つストリームに保存すると、その古い終端バイトが残り、出力が壊れます。保存する前にストリームをリセットまたは切り詰めてください。

CancellationTokenはIronWordが文書を読み込みや保存する際に停止させることができますか?

トークンはファイルまたはストリームI/Oのみをキャンセルします。読み込んだ文書の解析や保存された文書のシリアライズは同期的なステップであり、トークンは中断できません。

IronWordでバイト配列を読み込んだり保存したりする非同期メソッドはありますか?

デザイン上、いいえ。バイト配列からの読み込みとバイト配列への保存にはI/Oが関与しないため、IronWordはこれらのメモリ内の場合に同期的なバイト配列コンストラクタとSaveメソッドを維持しています。

IronWordのWordDocumentはスレッドセーフですか?

いいえ。単一のWordDocumentインスタンスはスレッドセーフではないため、例としてTask.WhenAllを使用して、同じ文書に対して保存操作を同時に実行しないでください。

最初にディスクに保存せずにアップロードからWord文書を読み込むことができますか?

はい。アップロードされたストリームを直接WordDocumentのコンストラクタまたはLoadAsyncに渡し、メモリ内で文書を編集し、ストリームに保存して、ファイルがディスクに触れることがないようにします。

Word文書をストリームに保存するにはIronWordのライセンスが必要ですか?

はい。ストリームへの保存には有効なIronWordライセンスが必要であり、ファイルパスやバイト配列への保存と同じです。

Ahmadは、C#、Python、およびウェブ技術に強い基盤を持つフルスタック開発者です。彼はスケーラブルなソフトウェアソリューションの構築に深い関心を持ち、デザインと機能が実際のアプリケーションでどのように融合するかを探求することを楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 62,392バージョン:2026.11ちょうどリリースされました