C#에서 DOCX 파일에서 텍스트를 제거하는 방법

워드 문서에서 단락 전체를 삭제하려면 어떻게 해야 하나요?

워드 문서에서 단락을 제거하려면, 인덱스 위치를 사용하여 Paragraphs 컬렉션을 통해 접근하세요. 이 예제는 인덱스 1에 있는 단락을 삭제하며, 이로 인해 해당 단락의 모든 내용과 서식이 삭제됩니다. 삭제 후 문서 구조가 자동으로 조정되며, 이후 단락들이 위로 이동하여 빈 공간을 채웁니다.

단락 삭제 작업을 할 때는 인덱싱이 0부터 시작한다는 점을 기억하세요. 첫 번째 단락은 인덱스 0에 있고, 두 번째 단락은 인덱스 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");

삭제하기 전 문서의 모습은 어떻습니까?

삭제 후 문서 구조는 어떻게 변경되나요?

삭제 작업은 문서의 전체적인 서식과 구조를 유지합니다. 나머지 단락은 원래 색상과 서식 속성을 유지합니다. IronWord의 제거 방법을 사용하는 핵심적인 장점은 바로 이것입니다. 대상 요소를 깔끔하게 제거하면서 주변 콘텐츠의 무결성을 그대로 유지한다는 점입니다.

단락 내에서 특정 서식이 적용된 텍스트를 제거하려면 어떻게 해야 하나요?

단락은 여러 개의 텍스트 구간을 포함할 수 있으며, 각 구간은 굵게, 기울임꼴 또는 색상과 같은 일관된 서식 속성을 가진 텍스트를 나타냅니다. 텍스트의 흐름을 이해하는 것은 정확한 콘텐츠 조작에 매우 중요합니다. 단락 내에서 서식이 변경될 때마다 새로운 텍스트 실행이 시작됩니다. 예를 들어, 문장에서 한 단어가 굵게 표시되어 있다면 일반적으로 세 개의 텍스트 영역이 있습니다. 굵게 표시된 단어 앞의 텍스트, 굵게 표시된 단어 자체, 그리고 굵게 표시된 단어 뒤의 텍스트입니다.

단락 내 특정 서식이 지정된 콘텐츠를 제거하려면 Texts 컬렉션에 접근하여 인덱스로 원하는 텍스트 실행을 타겟팅하세요. 이 예시는 첫 번째 단락에서 세 번째 텍스트 행(인덱스 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");

텍스트 구간을 작업할 때는 텍스트 구간을 삭제해도 주변 텍스트 구간의 서식에는 영향을 미치지 않는다는 점을 기억하세요. 각 텍스트 실행은 서식 속성을 독립적으로 유지합니다. 이를 통해 나머지 텍스트의 시각적 모양을 손상시키지 않고 특정 서식이 적용된 콘텐츠만 선택적으로 제거할 수 있습니다.

삭제되기 전 텍스트 행은 어떻게 되나요?

텍스트 연속 삭제는 단락 서식에 어떤 영향을 미치나요?

이미지에서 볼 수 있듯이 특정 텍스트 부분을 삭제해도 나머지 콘텐츠의 서식은 그대로 유지됩니다. 밑줄 친 텍스트와 기타 서식 속성은 변경되지 않고 그대로 유지되어 텍스트 배치 조작의 정확성을 보여줍니다.

위치가 아닌 내용으로 텍스트를 찾아 삭제하려면 어떻게 해야 하나요?

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

위 코드에서 null-조건부 연산자(?.)는 안전한 실행에 필수적입니다. 텍스트가 발견되지 않으면 FindText는 null을 반환하고, null-조건부 연산자는 NullReferenceException를 방지합니다. 이 패턴을 사용하면 대상 텍스트가 항상 존재하지 않을 수 있는 문서를 처리할 때 코드가 더욱 견고해집니다.

찾기 및 삭제 기능을 사용하기 전에 어떤 내용을 확인해야 할까요?

FindText 함수는 여러 번 나타나는 텍스트를 어떻게 처리하나요?

FindText을 사용할 때, 일치하는 텍스트의 첫 번째 발생을 반환한다는 점을 유의하세요. 문서 전체에서 특정 텍스트를 모두 제거해야 하는 경우, 더 이상 일치하는 항목이 없을 때까지 검색 및 제거를 반복하는 루프를 구현하십시오. 이러한 반복적인 접근 방식은 문서 전체에서 텍스트를 완벽하게 제거하는 것을 보장합니다.

찾기 및 삭제 기능은 삭제된 텍스트를 제외한 문서의 서식과 구조를 유지합니다. 단락 구분, 주변 텍스트 서식 및 문서 스타일은 그대로 유지되므로 원치 않는 콘텐츠를 제거하면서 문서 일관성을 유지하는 데 안전한 작업입니다.