GroupDocs.Editor で DOCX を編集し形式を変換する方法

.NET 環境で GroupDocs.Editor .NET を使用して Word ドキュメントを簡単に管理・変換できます。このチュートリアルでは how to edit docx ファイルの編集方法、RTF、DOCM、プレーンテキストなどの形式への変換方法、そしてドキュメントワークフローの自動化について学びます。

クイック回答

  • 必要なライブラリは何ですか? GroupDocs.Editor for .NET (20.10+).
  • DOCX を RTF に変換できますか? Yes – use WordProcessingSaveOptions with WordProcessingFormats.Rtf.
  • TXT として保存することはサポートされていますか? Absolutely, via TextSaveOptions.
  • ライセンスは必要ですか? A trial works for development; a license unlocks all features.
  • 多数のファイルを処理するにはどうすればよいですか? Combine the code with async/await or Parallel.ForEach for batch processing.

GroupDocs.Editor で “how to edit docx” とは何ですか?

GroupDocs.Editor は DOCX を読み込み、その内容を編集可能な HTML として公開し、プログラムからその HTML を変更できるようにし、結果を任意のサポートされた形式で保存します。このアプローチにより Office の相互運用が不要になり、サーバー側の .NET プラットフォーム上で動作します。

ドキュメントワークフロー自動化に GroupDocs.Editor を使用する理由

  • Server‑side only – Office のインストールは不要です。
  • Multiple output formats – RTF、DOCM、TXT、HTML、PDF など。
  • High performance – バッチシナリオ向けに設計された軽量 API。
  • Full control – 保存前に HTML フラグメントを編集、置換、または挿入できます。

前提条件

  • GroupDocs.Editor ライブラリ (Version 20.10 以上)
  • .NET Framework 4.7.2 + または .NET 5/6
  • Visual Studio (任意の最新エディション)
  • 基本的な C# の知識とファイル I/O の知識

GroupDocs.Editor のインストール

.NET CLI、Package Manager Console、または NuGet UI を使用してパッケージを追加できます。

dotnet add package GroupDocs.Editor
Install-Package GroupDocs.Editor

ライセンス取得

まずは無料トライアルで開始するか、一時的なライセンスキーをリクエストしてください。本番環境では、無制限の処理を利用できるライセンスを購入します。

DOCX ドキュメントの読み込みと編集方法

まず、エディタにソースファイルを指定し、編集可能な HTML を取得して必要な変更を加え、最後に変更されたマークアップから新しい EditableDocument を作成します。

using (Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/sample.docx", new Options.WordProcessingLoadOptions()))
{
    // Your document manipulation code here
}

ステップバイステップ コード解説

  1. 入力ファイルパスを定義する
string inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
  1. Editor インスタンスを作成する
using GroupDocs.Editor;
using GroupDocs.Editor.Options;

Editor editor = new Editor(inputFilePath, new Options.WordProcessingLoadOptions());
  1. ドキュメントの HTML を編集する
EditableDocument defaultWordProcessingDoc = editor.Edit();
string allEmbeddedInsideString = defaultWordProcessingDoc.GetEmbeddedHtml();
string allEmbeddedInsideStringEdited = allEmbeddedInsideString.Replace("Subtitle", "Edited subtitle");
  1. 編集された HTML から新しい EditableDocument を作成する
EditableDocument editedDoc = EditableDocument.FromMarkup(allEmbeddedInsideStringEdited, null);
  1. 一時オブジェクトを破棄する
editedDoc.Dispose();
defaultWordProcessingDoc.Dispose();
editor.Dispose();

Word を RTF に変換する方法

適切な保存オプションを使用すれば、編集したドキュメントを RTF として保存するのは簡単です。

string outputRtfPath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "editedDoc.rtf");
WordProcessingSaveOptions rtfSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);
using (Editor editor = new Editor(inputFilePath, new Options.WordProcessingLoadOptions()))
{
    editor.Save(editedDoc, outputRtfPath, rtfSaveOptions);
}
editor.Dispose();

ストリームを使用して DOCX を DOCM として保存する方法

マクロ対応の DOCM 形式が必要な場合は、FileStream に直接書き込むことができます。

string outputDocmPath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "editedDoc.docm");
WordProcessingSaveOptions docmSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm);
using (Editor editor = new Editor(inputFilePath, new Options.WordProcessingLoadOptions()))
{
    using (FileStream outputStream = File.Create(outputDocmPath))
    {
        editor.Save(editedDoc, outputStream, docmSaveOptions);
    }
}
editor.Dispose();

DOCX を TXT(プレーンテキスト)に変換する方法

プレーンテキストの抽出は、インデックス作成、検索、メール通知などに便利です。

string outputTxtPath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "editedDoc.txt");
TextSaveOptions textSaveOptions = new TextSaveOptions()
{
    Encoding = Encoding.UTF8,
    PreserveTableLayout = true
};
using (Editor editor = new Editor(inputFilePath, new Options.WordProcessingLoadOptions()))
{
    editor.Save(editedDoc, outputTxtPath, textSaveOptions);
}
editor.Dispose();

一般的なユースケースと実際のシナリオ

  • Automated Report Generation: 分析用 Word レポートを TXT に変換し、メール配信に利用します。
  • Collaborative Editing Platforms: ユーザーが HTML フラグメントを編集し、その結果を DOCM または RTF として保存できるようにします。
  • Document Archiving: 既存の DOCX ファイルをマクロ対応の DOCM に移行し、コンテンツを保持します。
  • Web Services: 一時ファイルを使用せずに、DOCX → PDF/RTF の変換をリアルタイムでストリーミングします。

Word ドキュメントのバッチ処理パフォーマンス向上のヒント

  • Dispose promptly: Editor とドキュメントオブジェクトは必ず Dispose() を呼び出してください。
  • Load wisely: 不要な解析を避けるために、最も具体的な LoadOptions を選択してください。
  • Parallelize safely: スレッドごとに別々の Editor インスタンスを使用して Parallel.ForEach を活用してください。
  • Avoid large in‑memory strings: 大容量ドキュメントを処理する際は、完全な HTML 文字列ではなくストリームを使用してください。

よくある質問

Q: パスワードで保護された DOCX を編集できますか?
A: はい。Editor を作成する際に WordProcessingLoadOptions.Password でパスワードを指定してください。

Q: 一度に多数のファイルを変換することは可能ですか?
A: 可能です。単一ファイルのロジックをループで包むか、Parallel.ForEach を使用して同時処理してください。

Q: GroupDocs.Editor は .NET Core をサポートしていますか?
A: このライブラリは .NET 5、.NET 6、.NET Core 3.1 だけでなく、フル .NET Framework でも動作します。

Q: DOCM として保存した場合、マクロはどうなりますか?
A: Docm 保存形式を使用するとマクロは保持されますが、RTF/TXT では除去されます。

Q: 大規模バッチジョブで “OutOfMemoryException” が発生した場合、どう対処すればよいですか?
A: ファイルを小さなバッチに分割して処理し、オブジェクトはすぐに破棄し、必要に応じてアプリケーションのメモリ上限を増やすことを検討してください。

結論

これで、how to edit docx ファイルを編集し、GroupDocs.Editor .NET を使用して RTF、DOCM、プレーンテキストに変換する完全な本番対応ワークフローが手に入りました。上記の手順に従うことで、ドキュメントワークフローの自動化、バッチ処理の実行、任意の .NET アプリケーションへのシームレスな形式変換の統合が可能になります。


最終更新日: 2026-04-07
テスト環境: GroupDocs.Editor 20.10 (latest at time of writing)
作者: GroupDocs