Aspose.Words FOSS for .NET のユースケース

Aspose.Words FOSS for .NET は、Microsoft Word をインストールせずに Word 文書の作成、編集、変換を行える pure-C# ライブラリです。以下のユースケースは、このオープンソース版が実際にサポートしている内容を、基盤に構築されています。 Document and DocumentBuilder. ページレイアウト、レンダリング、または PDF/画像エクスポートは含まれていません。詳細は、 FAQ and Troubleshooting ページで、このエディションが除外している項目の全リストをご確認ください。

サーバーサイドドキュメント生成

Office のインストールや COM オートメーションなしで、稼働中のサービスからレポート、レター、契約書を作成します — Docker コンテナやクラウドファンクションに最適です。Document を構築し、DocumentBuilder で駆動し、結果を保存します:

using Aspose.Words;

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Writeln("Hello, Aspose.Words FOSS!");

doc.Save("output.docx");

このライブラリは .NET Standard 2.0 を対象とし、ネイティブ依存関係がないため、同じコードが Windows、Linux、macOS のホスト上でそのまま実行できます。

テンプレートベースのドキュメント自動化

既存の DOCX テンプレートを開き、ビルダーのカーソルを名前付きブックマークに移動し、その位置に新しいコンテンツを書き込みます — 固定レイアウトから契約書、レター、請求書を埋め込む一般的なパターンです:

using Aspose.Words;

Document doc = new Document("template.docx");
DocumentBuilder builder = new DocumentBuilder(doc);

builder.MoveToBookmark("CustomerName");
builder.Write("Acme Corp");

doc.Save("output.docx");

DocumentBuilder は、テンプレートの他の部分を対象とするための MoveToSection()、MoveToParagraph()、MoveToStructuredDocumentTag() も提供し、複数のソース文書から取得したコンテンツを単一の出力ファイルに結合するための Document.AppendDocument() / NodeImporter も提供します。

DOCX バリアント、Markdown、プレーンテキスト間の形式変換

サポートされている形式のいずれかでドキュメントを読み込み、別の形式で保存します — DOCX、DOCM、DOTX、DOTM、Flat OPC はすべて同じ OOXML リーダー/ライターを共有しており、Markdown とプレーンテキストも双方向でサポートされています：

using Aspose.Words;

Document doc = new Document("report.docx");
doc.Save("report.md");

同じパターンを逆方向でも使用できます — .md ファイルを読み込み、.docx として保存します — これにより、Markdown で記述されたドキュメントを配布可能な Word ファイルに変換したり、DOCX コンテンツを Markdown ベースの静的サイトパイプラインに流し込んだりするのに便利です。

検索とインデックス作成のためのテキスト抽出

Word でレンダリングしたりファイルを開いたりすることなく、検索インデックス、テキスト解析パイプライン、または簡易コンテンツプレビューのために、ドキュメントからプレーンテキストコンテンツを抽出します：

using Aspose.Words;

Document doc = new Document("contract.docx");
string text = doc.GetText();

GetText() は Document と個々のノード（CompositeNode.GetText()、Node.GetText()、Row.GetText() など）でも利用可能で、ドキュメント全体からあるいは特定の部分からテキストを抽出できます。

バッチドキュメント処理

単一のスクリプトでディレクトリ内のファイルに対して同じ「読み込み-変更-保存」シーケンスを適用します — 例えば、DOCX ファイルが入ったフォルダー全体を Markdown に変換する場合などです：

using Aspose.Words;
using System.IO;

foreach (string path in Directory.GetFiles("incoming", "*.docx"))
{
    Document doc = new Document(path);
    doc.Save(Path.ChangeExtension(path, ".md"));
}

各ファイルは個別にロード、変換、保存されるため、同じループを任意のサポートされているソースおよびターゲットフォーマットの組み合わせに適用できます。