C#でDOCXからテキストを削除する方法

Word文書から段落全体を削除するにはどうすればよいですか?

Word 文書から段落を削除するには、インデックス位置を使用してParagraphsコレクションから段落にアクセスします。 この例では、インデックス1の段落を削除し、その内容と書式をすべて削除しています。 文書構造は、削除後に自動的に調整され、後続の段落がギャップを埋めるようにシフトアップします。

段落を削除する場合は、インデックスがゼロベースであることを忘れないでください。 最初の段落はインデックス0、2番目の段落はインデックス1、といった具合です。 Remove()メソッドは、すべてのテキストの実行、書式設定、その段落内の画像やハイパーリンクのような埋め込みコンテンツを含め、文書構造から段落要素を完全に削除します。

:path=/static-assets/word/content-code-examples/how-to/remove-text-simple.cs

using IronWord;

// Load a DOCX document
WordDocument doc = new WordDocument("text_document.docx");

// Remove the second paragraph
doc.Paragraphs[1].Remove();

// Export the file
doc.SaveAs("text_document_modified.docx");

IRON VB CONVERTER ERROR developers@ironsoftware.com

削除前のドキュメントはどのようなものですか?

削除後、文書構造はどのように変化しますか?

削除作業では、文書全体の書式と構造を維持します。 残りの段落は、元の色と書式のプロパティを保持します。 これは、IronWordの除去メソッドを使用する主な利点です。ターゲットとなる要素をきれいに除去しながら、周囲のコンテンツの整合性を保つことができます。

段落内の特定の書式付きテキストを削除するにはどうすればよいですか?

段落には複数のテキスト ランを含めることができ、各ランは太字、斜体、色などの一貫した書式設定プロパティを持つテキストを表します。 正確なコンテンツ操作のためには、テキストランを理解することが重要です。 段落内で書式が変わるたびに、新しいテキストが始まります。 たとえば、1つの単語が太字になっている文章がある場合、通常、太字の前のテキスト、太字の単語そのもの、太字の後のテキストの3つのテキストがあります。

段落内の特定の書式設定されたコンテンツを削除するには、 Textsコレクションにアクセスし、インデックスによって実行される目的のテキストをターゲットにします。 この例では、最初の段落から 3 番目のテキスト ラン (インデックス 2) を削除し、他のコンテンツはそのまま残します。 このきめ細かなコントロールにより、段落構造を維持しながら、特定の書式セグメントのみを削除することができます。

:path=/static-assets/word/content-code-examples/how-to/remove-text-text-run.cs

using IronWord;

// Load a DOCX document
WordDocument doc = new WordDocument("sample.docx");

// Remove the first paragraph's third textrun
doc.Paragraphs[0].Texts[2].Remove();

// Export the file
doc.SaveAs("sample_after_textrun_removal.docx");

IRON VB CONVERTER ERROR developers@ironsoftware.com

テキストランを使用する場合、テキストランを削除しても、周囲のランのフォーマットには影響しないことを覚えておいてください。 各テキストは、独立してフォーマットプロパティを維持します。 このため、残りのテキストの視覚的な外観を崩すことなく、特定の書式のコンテンツを外科的に削除することが可能です。

削除前のテキストはどうなりますか?

.

テキストを削除すると、段落の書式設定にどのような影響がありますか?

画像に示すように、特定のテキストを削除しても、残りのコンテンツの書式は維持されます。 下線テキストやその他の書式プロパティは変更せず、テキスト実行操作の正確さを示します。

位置ではなく内容でテキストを検索して削除するにはどうすればよいですか?

FindTextメソッドは、位置ではなくテキストの一致に基づいてコンテンツを動的に検索して削除します。 これは、無効なテキスト、プレースホルダ、または正確な場所を知らなくてもドキュメントの任意の場所にある特定のコンテンツを削除する場合に特に便利です。 このメソッドは一致するテキスト要素を返すか、見つからない場合は null を返すため、 Remove呼び出す前に null チェックを行って安全に削除できます。

このアプローチは、プレースホルダ・テキストの削除が必要なテンプレート・ドキュメントを扱う場合や、既知のエラー・パターンを含むドキュメントをクリーンアップする場合に非常に有効です。 FindText メソッドは、デフォルトで大文字と小文字を区別して検索を行い、ターゲット コンテンツの正確なマッチングを保証します。

:path=/static-assets/word/content-code-examples/how-to/remove-text-find.cs

using IronWord;

// Load the document
WordDocument doc = new WordDocument("sample.docx");

// Find and remove erroneous text
var textToRemove = doc.FindText("ERRONEOUS TEXT IS HERE.");
textToRemove?.Remove();

// Save the cleaned document
doc.SaveAs("sample_cleaned.docx");

IRON VB CONVERTER ERROR developers@ironsoftware.com

上記のコード内のヌル条件演算子（?.）は、安全な実行のために重要です。 テキストが見つからない場合、FindText は null を返し、null-conditional 演算子は NullReferenceException<//code> を防ぎます。 このパターンは、ターゲットテキストが常に存在するとは限らないドキュメントを扱うときに、コードをより堅牢にします。

検索と削除を使用する前に、どのようなコンテンツを探す必要がありますか?

.

どのように FindText は複数の出現を処理しますか?

.

FindTextを使用する場合、マッチするテキストが最初に出現する箇所を返すことに注意してください。 文書全体で特定のテキストをすべて削除する必要がある場合は、一致するテキストがなくなるまで検索と削除を続けるループを実装します。 この反復的なアプローチにより、文書全体にわたって包括的なテキスト除去が保証されます。

検索と削除の機能により、削除されたテキスト以外の文書の書式と構造が保持されます。 段落の区切り、周囲のテキストの書式、ドキュメントスタイルはそのままで、不要なコンテンツを削除しながらドキュメントの一貫性を維持する安全な作業です。