Wie man Text in einem Word-Dokument mit C# ersetzt

Wie sieht das Eingabedokument aus?

In diesem Beispiel verwenden wir dieses Muster-Word-Dokument, das zwei Absätze enthält, beide mit dem Text "alter Text". Diese einfache Struktur demonstriert, wie die Textersetzung auf Absatzebene funktioniert.

Wie schreibe ich den Ersetzungscode?

Hier ist der Code, um den "alten Text" des ersten Absatzes durch den "neuen Text" zu ersetzen. Beachten Sie, wie wir die Indexnotation verwenden, um bestimmte Absätze zu markieren, wodurch wir genau steuern können, welche Inhalte geändert werden:

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Der obige Code zeigt, wie einfach die Textersetzung mit IronWord ist. Durch das Laden des Dokuments, das Auswählen eines bestimmten Absatzes und den Aufruf von ReplaceText können Sie den Inhalt des Dokuments mit nur wenigen Codezeilen ändern. Dieser Ansatz ist unkomplizierter als die traditionellen Office-Interop-Methoden.

Wie sieht die Ausgabe aus?

Wie Sie in der Ausgabedatei sehen können, wurde nur der Text des ersten Absatzes geändert, während der zweite unverändert bleibt. Diese Fähigkeit zur selektiven Ersetzung ist entscheidend, wenn Sie bestimmte Abschnitte aktualisieren müssen, ohne das gesamte Dokument zu verändern.

Welchen Code benötige ich für Mehrfachersetzungen?

Hier ist der Code, um alle Vorkommen von "alter Text" durch "neuer Text" im gesamten Dokument zu ersetzen:

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Dieser Ansatz mit Schleifen bietet eine vollständige Abdeckung Ihres Dokuments. Indem Sie jeden Absatz durchgehen, stellen Sie sicher, dass alle Instanzen des Zieltextes ersetzt werden. Diese Methode ist besonders nützlich für Massenaktualisierungen, wie z. B. die Änderung von Firmennamen, die Aktualisierung von Terminologie oder die Anwendung einer einheitlichen Formatierung in einem Dokument.

Wie wird das Dokument nach mehreren Ersetzungen aussehen?

Wie Sie in diesem aktualisierten Word-Dokument sehen können, wurden beide Absätze durch "neuen Text" ersetzt. Dies demonstriert die Effektivität des Loop-Ansatzes für eine umfassende Textersetzung.

Wie kann ich das Vorhandensein von Text vor dem Ersetzen überprüfen?

Wenn Sie vor der Durchführung einer Operation überprüfen müssen, ob Text vorhanden ist, verwenden Sie die Methode FindText. Diese Methode durchsucht das gesamte Dokument und gibt das erste TextElement zurück, das die Suchanfrage erfüllt. Dieser Überprüfungsschritt kann nützlich sein, wenn Sie das Vorhandensein eines bestimmten Inhalts bestätigen müssen, bevor Sie Änderungen vornehmen, oder wenn Sie eine bedingte Logik auf der Grundlage des Dokumentinhalts erstellen.

Die Methode FindText ist besonders wertvoll in Szenarien, in denen:

• Sie müssen protokollieren, welche Dokumente bestimmten Text enthalten
• Je nachdem, ob der Text gefunden wird, sollen unterschiedliche Aktionen ausgeführt werden
• Sie bauen ein System zur Dokumentenvalidierung
• Sie müssen Berichte über den Inhalt der Dokumente erstellen

Unten ist ein Beispiel für die Suche nach dem alten Text in dem oben erwähnten Word-Dokument.

Welchen Code verwende ich, um Text zu finden?

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

IRON VB CONVERTER ERROR developers@ironsoftware.com

Dieser Code demonstriert die Einfachheit der Textsuche mit IronWord. Die FindText-Methode gibt ein TextElement-Objekt zurück, wenn der Text gefunden wird, oder null, wenn er nicht gefunden wird, was die Implementierung einer bedingten Logik auf der Grundlage der Suchergebnisse erleichtert.

Was zeigt das Ergebnis der Textsuche an?

Wie Sie sehen können, wurde der übereinstimmende Text zurückgegeben, was bestätigt, dass der Suchbegriff in dem Dokument vorhanden ist. Diese Überprüfungsfunktion ist für den Aufbau robuster Anwendungen zur Dokumentenverarbeitung, die verschiedene Inhaltsszenarien verarbeiten müssen, unerlässlich.