How to Replace Text in a Word Document with C#

입력 문서는 어떤 형태인가요?

이 예시에서는 "이전 텍스트"라는 텍스트가 포함된 두 개의 단락이 있는 샘플 워드 문서를 사용하겠습니다. 이 간단한 구조는 단락 수준에서 텍스트 바꾸기가 어떻게 작동하는지 보여줍니다.

교체 코드는 어떻게 작성하나요?

다음은 첫 번째 단락의 "기존 텍스트"를 "새 텍스트"로 바꾸는 코드입니다. 특정 단락을 대상으로 색인 표기법을 사용하여 어떤 콘텐츠를 수정할지 정확하게 제어하는 ​​방식을 살펴보세요.

:path=/static-assets/word/content-code-examples/how-to/replace-words.cs

using IronWord;

// Open existing Word
WordDocument doc = new WordDocument("sample.docx");

// Replace the first paragraph's old text with new text
doc.Paragraphs[0].ReplaceText("old text", "new text");

// Save updated Word Document
doc.SaveAs("updated.docx");

위 코드는 IronWord 사용한 텍스트 바꾸기의 간편함을 보여줍니다. 문서를 로드하고 특정 문단을 타겟으로 하며 ReplaceText를 호출함으로써, 몇 줄의 코드만으로 문서 내용을 수정할 수 있습니다. 이 접근 방식은 기존의 오피스 상호 운용 방식보다 더 간단합니다.

출력 결과는 어떻게 나타나나요?

출력 파일 에서 볼 수 있듯이 첫 번째 단락의 텍스트만 변경되었고 두 번째 단락은 변경되지 않았습니다. 이러한 선택적 교체 기능은 문서 전체에 영향을 주지 않고 특정 부분만 업데이트해야 할 때 매우 중요합니다.

여러 번 교체하려면 어떤 코드가 필요합니까?

다음은 문서 전체에서 "기존 텍스트"를 "새 텍스트"로 모두 바꾸는 코드입니다.

:path=/static-assets/word/content-code-examples/how-to/replace-words-multiple.cs

using IronWord;

// Open existing Word
WordDocument doc = new WordDocument("sample.docx");

// Loop through each paragraph to find and replace text
for (int i = 0; i < doc.Paragraphs.Count; i++)
{
    // Replace all occurrences of "old text" with "new text" in the current paragraph
    doc.Paragraphs[i].ReplaceText("old text", "new text");
}

// Save updated Word Document
doc.SaveAs("updated.docx");

이 반복 방식을 통해 문서 전체를 완벽하게 검사할 수 있습니다. 모든 단락을 순회함으로써 대상 텍스트가 나타나는 모든 부분을 대체할 수 있습니다. 이 방법은 회사 이름 변경, 용어 업데이트 또는 문서 전체에 일관된 서식 적용과 같은 대량 업데이트에 특히 유용합니다.

여러 번 문서를 교체한 후에는 문서가 어떤 모습일까요?

업데이트된 워드 문서 에서 보시는 바와 같이 두 단락 모두 "새 텍스트"로 대체되었습니다. 이는 반복문 방식이 포괄적인 텍스트 교체에 효과적임을 보여줍니다.

텍스트를 바꾸기 전에 해당 텍스트가 이미 존재하는지 어떻게 확인할 수 있나요?

작업을 수행하기 전에 텍스트가 존재하는지 확인해야 한다면, FindText 메서드를 사용하세요. 이 메서드는 문서 전체를 검색하고 검색 쿼리에 일치하는 첫 번째 TextElement를 반환합니다. 이 검증 단계는 변경 작업을 수행하기 전에 특정 콘텐츠의 존재 여부를 확인해야 하거나 문서 콘텐츠를 기반으로 조건부 논리를 구축할 때 유용할 수 있습니다.

특히 다음과 같은 시나리오에서 FindText 메서드는 매우 유용합니다:

• 특정 텍스트가 포함된 문서를 기록해야 합니다.
• 텍스트가 있는지 여부에 따라 다른 작업을 수행하고 싶습니다.
• 문서 유효성 검사 시스템을 구축하고 있습니다.
• 문서 내용에 대한 보고서를 생성해야 합니다.

아래는 위에서 언급한 워드 문서에서 이전 텍스트를 검색하는 예시입니다.

텍스트를 찾으려면 어떤 코드를 사용해야 하나요?

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

using IronWord;
using System;

// Open existing Word
WordDocument doc = new WordDocument("sample.docx");

// Returns the first TextContent element that contains the specified text.
Console.WriteLine(doc.FindText("old text"));

이 코드는 IronWord 사용한 텍스트 검색의 간편함을 보여줍니다. FindText 메서드는 텍스트가 발견되면 TextElement 객체를 반환하고, 그렇지 않으면 null을 반환하여 검색 결과를 기반으로 조건부 로직을 쉽게 구현할 수 있게 해줍니다.

텍스트 찾기 결과는 무엇을 보여주나요?

보시다시피, 일치하는 텍스트가 반환되어 검색어가 문서에 존재함을 확인시켜 줍니다. 이러한 검증 기능은 다양한 콘텐츠 시나리오를 처리해야 하는 견고한 문서 처리 애플리케이션을 구축하는 데 필수적입니다.