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

Die Automatisierung von Textersetzungen in Word-Dokumenten ist ein verbreitetes Bedürfnis, sei es, um Vorlagen zu personalisieren, Berichte zu aktualisieren oder Inhalte in großen Mengen zu verwalten. IronWord ist eine C#-Bibliothek, die darauf ausgelegt ist, diese Aufgabe einfach und effizient zu gestalten.

Ein wesentlicher Vorteil von IronWord ist, dass es Word-Dokumente direkt manipuliert, ohne auf Microsoft Office Interop angewiesen zu sein. Das bedeutet, dass Word nicht auf Ihrem Server installiert sein muss, was zu einer erheblich schnelleren, zuverlässigeren und skalierbareren Lösung für Backend-Prozesse und Webanwendungen führt.

In dieser Anleitung werden wir Codebeispiele durchgehen, um Ihnen zu zeigen, wie einfach Sie Text in jedem Word-Dokument finden und ersetzen können.

als-Überschrift:2(Schnellstart: Text in Word-Dokumenten einfach ersetzen)

Diese Kurzanleitung zeigt, wie man schnell Text in einem Word-Dokument mit IronWord ersetzen kann. Mit nur wenigen Zeilen C# können Sie eine DOCX-Datei laden, den angegebenen Text ersetzen und das aktualisierte Dokument speichern. Dieser effiziente Prozess stellt sicher, dass Entwickler die Dokumentenautomatisierung verbessern können, ohne Microsoft Office Interop zu benötigen, was es ideal für Backend-Prozesse und Webanwendungen macht.

Beispiel für das Ersetzen von Text

Das Ersetzen von Text in einem Word-Dokument ist intuitiv mit IronWord. Zuerst laden wir ein bestehendes Dokument. Dann greifen wir über Paragraphs auf die Absatzsammlung zu und verwenden die Methode ReplaceText in einem bestimmten Absatz.

Die ReplaceText-Methode nimmt zwei Zeichenfolgenparameter: den zu findenden Text und den Text, durch den er ersetzt werden soll.

Tipps Die ReplaceText Methode unterscheidet zwischen Groß- und Kleinschreibung und ersetzt alle Vorkommen der Zeichenfolge innerhalb des ausgewählten Absatzes.

TippsAlle in diesem Beispiel verwendeten Objektlisten verwenden eine nullbasierte Indizierung.

Eingabe

In diesem Beispiel werden wir dieses Beispiel Word-Dokument verwenden, das zwei Absätze enthält, beide mit dem Text "alter Text".

Code

Hier ist der unten stehende Code, wir werden den ersten Absatz von "altem Text" mit dem Wort "neuer Text" ersetzen.

: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

$vbLabelText   $csharpLabel

Ausgabe

Wie Sie in der Ausgabedatei sehen können, wurde nur der Text des ersten Absatzes geändert, während der zweite unverändert bleibt.

Mehrfachen Text ersetzen

Um jede Vorkommen eines Wortes im gesamten Dokument zu ersetzen, durchlaufen Sie die Paragraphs-Sammlung und wenden Sie die ReplaceText-Methode auf jeden einzelnen an.

Wir verwenden dieselbe Datei sample.docx wie zuvor. Wenn der zu ersetzende Text in einem Absatz nicht gefunden wird, wird keine Operation durchgeführt und die Schleife geht zum nächsten Absatz über.

Hinweis: Wenn der zu ersetzende Text nicht gefunden wird, werden keine Operationen ausgeführt.

Code

Hier ist der unten stehende Code, wir werden den ersten Absatz von "altem Text" mit dem Wort "neuer Text" 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

$vbLabelText   $csharpLabel

Ausgabe

Wie Sie in diesem aktualisierten Word-Dokument sehen können, wurden beide Absätze mit dem Wort "neuer Text" ersetzt.

Text finden

Wenn Sie sicherstellen müssen, dass ein Text vor einer Operation existiert, können Sie die FindText-Methode verwenden. Diese Methode durchsucht das gesamte Dokument und gibt das erste TextElement zurück, das die Suchanfrage erfüllt.

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

Code

: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

$vbLabelText   $csharpLabel

Ausgabe

Wie Sie sehen können, wurde der übereinstimmende Text zurückgegeben.

Warnung Wenn FindText nichts zurückgibt, existiert der Text nicht im Dokument. Stellen Sie sicher, dass Ihr Suchbegriff korrekt geschrieben ist und der Groß-/Kleinschreibung des Textes im Dokument entspricht.