GroupDocs.Editor for .NET を使用したプレーンテキスト文書の編集
はじめに
.NET アプリケーションで プレーンテキスト を迅速かつ確実に編集する必要がある場合、GroupDocs.Editor for .NET が重い作業を代行してくれます。この API は 30 以上のドキュメント形式をサポートし、最大 500 MB のファイルを処理でき、ファイル全体をメモリにロードせずにテキストを操作できます。このチュートリアルでは、txt ファイルの読み込み、末尾スペースのトリム、先頭スペースの変換、正しいエンコーディングの設定、そして最終的に編集した内容をディスクに保存する方法を学びます。さっそく始めましょう!
クイック回答
- txt ファイルを編集する最初のステップは何ですか?
Editorを使用して、パスまたはストリームでファイルをロードします。 - 編集中にファイルのエンコーディングを変更できますか? はい –
TxtSaveOptionsで UTF‑8、UTF‑16、または任意のカスタムエンコーディングを指定できます。 - 各行の末尾の余分なスペースを削除するには? テキストを取得し、各行で
TrimEnd()を呼び出して、再度書き込みます。 - GroupDocs.Editor は無料で試せますか? リリースページから 30 日間のフル機能トライアルが利用可能です。
- 対応している .NET バージョンは? .NET Framework 4.6 以上、.NET Core 3.1 以上、そして .NET 5/6/7。
プレーンテキストの編集とは?
Edit plain text は、単純な .txt ファイル内の文字をプログラムで変更することを意味します—追加、削除、または再フォーマット—ファイルの元のエンコーディングと改行スタイルを保持したままです。空白のトリミング、改行コードの正規化、設定値の更新、生成コンテンツの挿入などの作業が含まれます。この操作は、標準的なテキストエディタでファイルが読み取れる状態を保ち、BOM マーカーなど既存のメタデータも維持する必要があります。
プレーンテキスト編集に GroupDocs.Editor を使用する理由
GroupDocs.Editor はストリーミング方式でファイルを処理するため、300 MB のログファイルでも 50 MB 未満の RAM で編集できます。このライブラリは 50 以上の入力および出力フォーマット をサポートし、改行スタイル(CR、LF、CRLF)を自動検出し、末尾スペースのトリム と 先頭スペースの変換 をカスタムパーサーを書かずに組み込みオプションで提供します。
前提条件
- .NET 開発環境 – Visual Studio 2022 または C# 拡張機能付き VS Code。
- GroupDocs.Editor for .NET – GroupDocs.Editor for .NET のリリースページからダウンロード。
- 基本的な C# 知識 – ファイル I/O と文字列操作に慣れている必要があります。
- テキストエディタ(任意) – ソースファイルの確認用;VS Code が推奨されます。
- 詳細な使用方法は、ドキュメント を参照してください。
- また、一般的な リリースページ も閲覧できます。
プレーンテキストの編集手順
ファイルをロードし、内容を編集し、保存します—コードは 10 行未満です。以下のセクションで各ステップをわかりやすく説明します。
手順 1: 入力 TXT ファイルへのパスを取得
まず、物理的なファイルパスで作業するか、メモリストリームで作業するかを決めます。ローカル開発ではパスを使用するのが最も簡単です。
using System.Collections.Generic;
using System.IO;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.HtmlCss.Resources;
using GroupDocs.Editor.Options;
手順 2: Editor インスタンスの作成
Editor はドキュメントをロードし、編集機能を提供する主要クラスです。
string inputFilePath = "YourSampleDocument.txt";
手順 3: TXT 編集オプションの作成
TxtEditOptions はプレーンテキストファイルの解析と編集方法を構成し、エンコーディングやスペース処理ルールを設定できます。
using (Editor editor = new Editor(inputFilePath))
{
手順 4: EditableDocument インスタンスの作成
EditableDocument はロードされたドキュメントのメモリ内バージョンを表し、テキストと関連リソースを含みます。
TextEditOptions editOptions = new TextEditOptions
{
Encoding = System.Text.Encoding.UTF8,
RecognizeLists = true,
LeadingSpaces = TextLeadingSpacesOptions.ConvertToIndent,
TrailingSpaces = TextTrailingSpacesOptions.Trim
};
手順 5: ドキュメント内容の編集
元のテキストを取得し、必要な文字列操作(例: 置換、トリム、ケース変換)を適用し、結果を EditableDocument に戻します。
EditableDocument beforeEdit = editor.Edit(editOptions);
手順 6: 更新された内容で EditableDocument を作成
テキストを変換した後、編集済み文字列と元のリソースコレクションを含む新しい EditableDocument をインスタンス化します。
string originalTextContent = beforeEdit.GetContent();
string updatedTextContent = originalTextContent.Replace("text", "EDITED text");
List<IHtmlResource> allResources = beforeEdit.AllResources;
手順 7: WordProcessing 保存オプションの作成
WordProcessingSaveOptions は DOCX や DOCM などの Word 互換形式で保存するための設定を定義します。
EditableDocument afterEdit = EditableDocument.FromMarkup(updatedTextContent, allResources);
手順 8: TXT 保存オプションの作成
TxtSaveOptions は編集されたプレーンテキストファイルの書き込み方法を指定し、エンコーディング、改行の保持、テーブルレイアウトの処理などを含みます。
WordProcessingSaveOptions wordSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm)
{
Locale = System.Globalization.CultureInfo.GetCultureInfo("en-GB")
};
手順 9: 出力パスの準備
入力ファイルパスから出力ディレクトリを導出し、DOCX と TXT の結果用の完全なファイル名を作成します。
TextSaveOptions txtSaveOptions = new TextSaveOptions
{
Encoding = System.Text.Encoding.UTF8,
PreserveTableLayout = true
};
手順 10: 編集済みドキュメントの保存
最後に、editor.Save を 2 回呼び出します—WordProcessing オプションで 1 回、TXT オプションで 1 回—1 回の操作で両方の形式を生成します。
string outputWordPath = Path.Combine(Path.GetDirectoryName(inputFilePath), Path.GetFileNameWithoutExtension(inputFilePath) + ".docm");
string outputTxtPath = Path.Combine(Path.GetDirectoryName(inputFilePath), Path.GetFileNameWithoutExtension(inputFilePath) + ".txt");
よくある問題と解決策
- 編集後に末尾スペースが残る – ドキュメントをロードする前に
TxtEditOptions.TrimTrailingSpacesがtrueに設定されていることを確認してください。 - 保存されたファイルのエンコーディングが正しくない –
TxtSaveOptions.Encodingが目的のコードページ(例:Encoding.UTF8)と一致しているか確認してください。 - 大きなファイルで OutOfMemoryException が発生 – メモリ使用量を抑えるために、ファイルパスからロードする代わりにストリーミング API(
Editor.Load(Stream))を使用してください。
よくある質問
Q: GroupDocs.Editor for .NET がサポートするファイル形式は何ですか?
A: ライブラリは 50 以上の形式をサポートし、DOCX、TXT、HTML、PDF、markdown などを含み、シームレスに編集および変換できます。
Q: GroupDocs.Editor for .NET の無料トライアルはどうやって入手できますか?
A: リリースページ からトライアルをダウンロードしてください。
Q: テスト用に一時ライセンスを購入できますか?
A: はい、一時ライセンスは GroupDocs 購入ページ で入手可能です。
Q: 問題が発生した場合、どこでサポートを受けられますか?
A: 公式サポートフォーラムが最適です – GroupDocs.Editor サポートフォーラム をご覧ください。
Q: 高度なシナリオ向けの詳細なドキュメントはありますか?
A: もちろんです。完全なリファレンスは GroupDocs.Editor ドキュメントページ にあります。
結論
これで、GroupDocs.Editor for .NET を使用して プレーンテキスト ファイルを編集する方法—txt ファイルのロード、スペースのトリム、先頭スペースの変換、適切なエンコーディングの設定、そして TXT と DOCX の両方の形式で保存—を習得しました。この機能により、ログファイルのクリーンアップを自動化したり、設定ファイルをオンザフライで生成したり、独自のテキスト処理パイプラインを構築したりできます。バッチ処理やドキュメント変換などの追加機能は、公式ドキュメントをご覧ください。
最終更新日: 2026-08-10
テスト環境: GroupDocs.Editor 23.11 for .NET
作者: GroupDocs
editor.Save(afterEdit, outputWordPath, wordSaveOptions);
editor.Save(afterEdit, outputTxtPath, txtSaveOptions);
}
System.Console.WriteLine("Document editing process completed successfully!");