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");

Imports IronWord

' Load a DOCX document
Dim doc As New WordDocument("text_document.docx")

' Remove the second paragraph
doc.Paragraphs(1).Remove()

' Export the file
doc.SaveAs("text_document_modified.docx")

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

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

削除作業では、文書全体の書式と構造を維持します。 残りの段落は、元の色と書式のプロパティを保持します。 これは、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");

Imports IronWord

' Load a DOCX document
Dim doc As 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")

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

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

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

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

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

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");

Imports IronWord

' Load the document
Dim doc As New WordDocument("sample.docx")

' Find and remove erroneous text
Dim textToRemove = doc.FindText("ERRONEOUS TEXT IS HERE.")
textToRemove?.Remove()

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

上記のコードの null 条件演算子 (?.) は、安全な実行に不可欠です。 テキストが見つからない場合、FindText は null を返し、null 条件演算子によって NullReferenceException が防止されます。 このパターンは、ターゲットテキストが常に存在するとは限らないドキュメントを扱うときに、コードをより堅牢にします。

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

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

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

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