How to Replace Text in a Word Document with C

Jak wygląda dokument źródłowy?

W tym przykładzie użyjemy tego przykładowego dokumentu Worda, który zawiera dwa akapity, oba z tekstem "stary tekst". Ta prosta struktura pokazuje, jak zamiana tekstu działa na poziomie akapitu.

Jak napisać kod zamiany?

Oto kod, aby zamienić "stary tekst" pierwszego akapitu na "nowy tekst". Zauważ jak używamy notacji indeksu, aby celować w konkretne akapity, dając nam precyzyjną kontrolę nad tym, która zawartość zostaje zmodyfikowana:

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

Imports IronWord

' Open existing Word
Dim doc As 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")

Powyższy kod demonstruje prostotę zamiany tekstu za pomocą IronWord. Ładując dokument, celując w konkretny akapit i wywołując ReplaceText, możesz zmodyfikować zawartość dokumentu w zaledwie kilka linijek kodu. To podejście jest bardziej bezpośrednie niż tradycyjne metody Interop Office.

Jak wygląda wynik?

Jak widać w plik z wynikami, tylko tekst pierwszego akapitu został zmieniony, podczas gdy drugi pozostaje nietknięty. Ta selektywna możliwość zamiany jest kluczowa, gdy potrzebujesz zaktualizować konkretne sekcje bez wpływu na cały dokument.

Jakiego kodu potrzebuję do wielu zamian?

Oto kod, aby zamienić wszystkie wystąpienia "stary tekst" na "nowy tekst" w całym dokumencie:

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

Imports IronWord

' Open existing Word
Dim doc As New WordDocument("sample.docx")

' Loop through each paragraph to find and replace text
For i As Integer = 0 To doc.Paragraphs.Count - 1
    ' Replace all occurrences of "old text" with "new text" in the current paragraph
    doc.Paragraphs(i).ReplaceText("old text", "new text")
Next

' Save updated Word Document
doc.SaveAs("updated.docx")

To rozwiązanie pętli zapewnia pełne pokrycie twojego dokumentu. Iterując przez każdy akapit, zapewniasz zastąpienie wszystkich wystąpień docelowego tekstu. Ta metoda jest szczególnie przydatna przy masowych aktualizacjach, takich jak zmiana nazw firm, aktualizacja terminologii lub stosowanie jednolitego formatowania w całym dokumencie.

Jak będzie wyglądał dokument po wielu zamianach?

Jak widać z tego zaktualizowanego dokumentu Word, oba akapity zostały zastąpione "nowym tekstem". To pokazuje skuteczność podejścia z pętlą do kompleksowej zamiany tekstu.

Jak mogę sprawdzić, czy tekst istnieje przed zamianą?

Jeśli musisz zweryfikować, że tekst istnieje przed wykonaniem operacji, użyj metody FindText. Ta metoda przeszukuje cały dokument i zwraca pierwsze TextElement, które odpowiada zapytaniu. Ten krok weryfikacji może być przydatny, gdy musisz potwierdzić obecność określonej zawartości przed wprowadzeniem zmian lub przy budowie logiki warunkowej na bazie zawartości dokumentu.

Metoda FindText jest szczególnie cenna w scenariuszach, gdzie:

• Musisz zarejestrować, które dokumenty zawierają określony tekst
• Chcesz wykonywać różne działania w zależności od tego, czy tekst został znaleziony
• Tworzysz system walidacji dokumentu
• Musisz generować raporty dotyczące zawartości dokumentów

Poniżej znajduje się przykład wyszukiwania starego tekstu w wymienionym wcześniej dokumencie Word.

Jaki kod stosuje się do znalezienia tekstu?

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

Imports IronWord
Imports System

' Open existing Word
Dim doc As New WordDocument("sample.docx")

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

Ten kod pokazuje prostotę wyszukiwania tekstu za pomocą IronWord. Metoda FindText zwraca obiekt TextElement, jeśli tekst zostanie znaleziony, lub null, jeśli nie, co czyni implementację logiki warunkowej na bazie wyników wyszukiwania łatwą.

Co pokazują wyniki wyszukiwania tekstu?

Jak widać, zwróciło pasujący tekst, potwierdzając, że termin wyszukiwania istnieje w dokumencie. Ta zdolność do weryfikacji jest niezbędna do budowania solidnych aplikacji przetwarzających dokumenty, które muszą obsługiwać różne scenariusze zawartości.