GroupDocs.Editor で DOCX を編集し形式を変換する方法
.NET 環境で GroupDocs.Editor .NET を使用して Word ドキュメントを簡単に管理・変換できます。このチュートリアルでは how to edit docx ファイルの編集方法、RTF、DOCM、プレーンテキストなどの形式への変換方法、そしてドキュメントワークフローの自動化について学びます。
クイック回答
- 必要なライブラリは何ですか? GroupDocs.Editor for .NET (20.10+).
- DOCX を RTF に変換できますか? Yes – use
WordProcessingSaveOptionswithWordProcessingFormats.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
}
ステップバイステップ コード解説
- 入力ファイルパスを定義する
string inputFilePath = "YOUR_DOCUMENT_DIRECTORY/sample.docx";
Editorインスタンスを作成する
using GroupDocs.Editor;
using GroupDocs.Editor.Options;
Editor editor = new Editor(inputFilePath, new Options.WordProcessingLoadOptions());
- ドキュメントの HTML を編集する
EditableDocument defaultWordProcessingDoc = editor.Edit();
string allEmbeddedInsideString = defaultWordProcessingDoc.GetEmbeddedHtml();
string allEmbeddedInsideStringEdited = allEmbeddedInsideString.Replace("Subtitle", "Edited subtitle");
- 編集された HTML から新しい
EditableDocumentを作成する
EditableDocument editedDoc = EditableDocument.FromMarkup(allEmbeddedInsideStringEdited, null);
- 一時オブジェクトを破棄する
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