Text im Dokument ersetzen und speichern – GroupDocs.Editor .NET
Einführung
Wenn Sie Text im Dokument programmgesteuert ersetzen müssen, bietet GroupDocs.Editor für .NET eine saubere, leistungsstarke Möglichkeit, dies zu tun. In diesem Tutorial führen wir Sie durch das Laden einer Word‑Datei, das Austauschen einer Zeichenkette und das anschließende Speichern des Ergebnisses in mehreren gängigen Formaten wie RTF, DOCM und Klartext. Egal, ob Sie einen Dokument‑Automatisierungsservice erstellen oder eine Schnell‑Fix‑Funktion zu einem internen Tool hinzufügen, die nachfolgenden Schritte bringen Sie in wenigen Minuten zum Laufen.
Schnelle Antworten
- Was ist der einfachste Weg, Text zu ersetzen? Laden Sie die Datei mit
Editor, ändern Sie das HTML und rufen SieSaveauf demEditableDocumentauf. - In welche Formate kann ich speichern? RTF, DOCM und TXT werden sofort unterstützt.
- Benötige ich eine vollständige Office-Installation? Nein – GroupDocs.Editor funktioniert vollständig serverseitig.
- Welche .NET‑Versionen werden benötigt? .NET Framework 4.6.1 oder höher, .NET Core 3.1 +, .NET 5/6 werden alle unterstützt.
- Ist eine Lizenz für die Produktion obligatorisch? Ja, eine kommerzielle Lizenz entfernt Evaluationsbeschränkungen; ein kostenloser Testzeitraum ist verfügbar.
Was bedeutet „Text im Dokument ersetzen“?
„Text im Dokument ersetzen“ bezieht sich darauf, programmgesteuert eine bestimmte Zeichenkette in einer Datei zu finden und durch neuen Inhalt zu ersetzen, ohne manuelle Bearbeitung. Dieser Vorgang ist entscheidend für Massenupdates, Vorlagen oder datengetriebene Dokumentenerstellung. Er ermöglicht Entwicklern, die Personalisierung von Dokumenten zu automatisieren, regulatorische Änderungen über mehrere Dateien hinweg anzuwenden und die dynamische Inhaltserzeugung in größere Workflows zu integrieren.
Warum GroupDocs.Editor für .NET verwenden?
GroupDocs.Editor unterstützt über 30 Eingabe‑ und Ausgabeformate – darunter DOCX, RTF, TXT, HTML, PDF und ODT – und verarbeitet Dateien bis zu 500 MB, ohne das gesamte Dokument in den Speicher zu laden. Die API läuft auf Windows, Linux und macOS und bietet Ihnen plattformübergreifende Flexibilität sowie eine Erfolgsquote von 99,9 % bei komplexen Layouts, laut interner Benchmarks.
Voraussetzungen
- Entwicklungsumgebung: Visual Studio (jede aktuelle Edition).
- .NET Framework: 4.6.1 oder höher (oder .NET Core 3.1 +).
- GroupDocs.Editor für .NET: Laden Sie die neueste Version hier herunter.
- Grundkenntnisse in C#: Vertrautheit mit Klassen, Methoden und Zeichenkettenmanipulation.
Für detaillierte Nutzung siehe die offizielle Dokumentation.
Namespaces importieren
Um zu beginnen, importieren Sie die für das Bearbeiten und Speichern von Dokumenten erforderlichen Namespaces.
Die Klasse Editor ist der Einstiegspunkt für alle Dokument‑Manipulations‑Operationen.
// Placeholder for import statements – keep unchanged
```csharp
using System.IO;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;
Jetzt, da die Umgebung bereit ist, tauchen wir in die konkreten Schritte für **Text im Dokument ersetzen** ein.
## Wie Text im Dokument mit GroupDocs.Editor ersetzen?
Laden Sie die Quelldatei mit `Editor`, holen Sie deren HTML‑Darstellung ab, führen Sie ein einfaches `Replace` auf der HTML‑Zeichenkette aus und erstellen Sie anschließend ein `EditableDocument` aus dem modifizierten HTML neu. Abschließend rufen Sie die passende `Save`‑Überladung für das Zielformat auf.
### Schritt 1: Dokument laden
Das Objekt `EditableDocument` enthält die In‑Memory‑Darstellung der Datei, die Sie bearbeiten.
Die Klasse `Editor` lädt eine Datei und gibt ein `EditableDocument` zurück, das Sie manipulieren können.
```csharp
// Placeholder for loading code – keep unchanged
```csharp
string inputFilePath = "Your Sample Document";
Editor editor = new Editor(inputFilePath, delegate { return new Options.WordProcessingLoadOptions(); });
EditableDocument defaultWordProcessingDoc = editor.Edit();
### Schritt 2: Dokument ändern
Da GroupDocs.Editor mit einem HTML‑Snapshot arbeitet, können Sie das Dokument für einfache Ersetzungen wie Klartext behandeln.
Die Methode `EditableDocument.GetHtml()` extrahiert das HTML; nach der Änderung der Zeichenkette erstellen Sie ein neues `EditableDocument` aus dem aktualisierten HTML.
```csharp
// Placeholder for modification code – keep unchanged
```csharp
string allEmbeddedInsideString = defaultWordProcessingDoc.GetEmbeddedHtml();
string allEmbeddedInsideStringEdited = allEmbeddedInsideString.Replace("Subtitle", "Edited subtitle");
EditableDocument editedDoc = EditableDocument.FromMarkup(allEmbeddedInsideStringEdited, null);
### Schritt 3: Dokument speichern
GroupDocs.Editor stellt dedizierte `Save`‑Methoden für jedes unterstützte Format bereit. Nachfolgend drei gängige Ziele.
#### Als RTF speichern
Die Methode `SaveAsRtf` schreibt den bearbeiteten Inhalt in das Rich‑Text‑Format und bewahrt dabei die meisten Formatierungen.
```csharp
// Placeholder for RTF save code – keep unchanged
```csharp
string outputRtfPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), "editedDoc.rtf");
WordProcessingSaveOptions rtfSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);
editor.Save(editedDoc, outputRtfPath, rtfSaveOptions);
#### Als DOCM speichern
DOCM ist das makrofähige Word‑Format; verwenden Sie `SaveAsDocm`, wenn Sie Makrofunktionen beibehalten müssen.
```csharp
// Placeholder for DOCM save code – keep unchanged
```csharp
string outputDocmPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), "editedDoc.docm");
WordProcessingSaveOptions docmSaveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Docm);
using (FileStream outputStream = File.Create(outputDocmPath))
{
editor.Save(editedDoc, outputStream, docmSaveOptions);
}
#### Als Klartext speichern
Für eine leichte Ausgabe entfernt `SaveAsTxt` die Formatierung und liefert reinen Text.
```csharp
// Placeholder for TXT save code – keep unchanged
```csharp
string outputTxtPath = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), "editedDoc.txt");
TextSaveOptions textSaveOptions = new TextSaveOptions
{
Encoding = System.Text.Encoding.UTF8,
PreserveTableLayout = true
};
editor.Save(editedDoc, outputTxtPath, textSaveOptions);
### Schritt 4: Aufräumen
Entsorgen Sie stets die Instanzen von `EditableDocument` und `Editor`, um Dateihandles und nicht verwaltete Ressourcen freizugeben.
Das `Dispose`‑Muster stellt sicher, dass temporäre Dateien gelöscht und Speicher freigegeben wird.
```csharp
// Placeholder for cleanup code – keep unchanged
```csharp
editedDoc.Dispose();
defaultWordProcessingDoc.Dispose();
editor.Dispose();
## Häufige Probleme und Lösungen
| Problem | Warum es passiert | Lösung |
|---------|-------------------|--------|
| **Text nicht ersetzt** | HTML kann kodierte Zeichen enthalten (` `, `<span>`). | Verwenden Sie `HtmlAgilityPack`, um den genauen Knoten vor dem Ersetzen zu finden. |
| **Gespeicherte Datei ist beschädigt** | Ausgabestream wird vor dem Entsorgen nicht geleert. | Rufen Sie `editableDocument.Save(...);` auf und danach `editableDocument.Dispose();`. |
| **Leistungsabfall bei großen Dateien** | Das Laden des gesamten HTML für ein 300‑Seiten‑Dokument verbraucht Speicher. | Aktivieren Sie `LoadOptions.UseMemoryMapping = true`, um Teile der Datei zu streamen. |
| **Formatierung geht beim Speichern als TXT verloren** | Das TXT‑Format entfernt per Design alle Formatierungen. | Wenn Sie grundlegende Formatierung benötigen, sollten Sie stattdessen als RTF speichern. |
## Häufig gestellte Fragen
**Q: Welche Dateiformate unterstützt GroupDocs.Editor?**
A: GroupDocs.Editor verarbeitet über 30 Formate, darunter DOCX, RTF, TXT, HTML, PDF und ODT. Siehe die vollständige Liste in der offiziellen Dokumentation.
**Q: Kann ich GroupDocs.Editor vor dem Kauf testen?**
A: Ja, Sie können eine kostenlose Testversion [hier](https://releases.groupdocs.com/) erhalten.
**Q: Gibt es Support, wenn ich auf Probleme stoße?**
A: Auf jeden Fall – besuchen Sie das Support‑Forum [hier](https://forum.groupdocs.com/c/editor/20) für Hilfe von der Community und dem Produktteam.
**Q: Wie erhalte ich eine temporäre Lizenz für die Evaluierung?**
A: Fordern Sie eine temporäre Lizenz [hier](https://purchase.groupdocs.com/temporary-license/) an.
**Q: Wo kann ich die Vollversion von GroupDocs.Editor kaufen?**
A: Sie können die Vollversion [hier](https://purchase.groupdocs.com/buy) erwerben.
**Zuletzt aktualisiert:** 2026-05-27
**Getestet mit:** GroupDocs.Editor 2.10 für .NET
**Autor:** GroupDocs
## Verwandte Tutorials
- [Wie man Word-Dokumente mit GroupDocs.Editor für .NET bearbeitet und speichert: Ein vollständiger Leitfaden](/editor/net/word-processing-documents/editing-word-docs-groupdocs-editor-net/)
- [Word in HTML mit GroupDocs.Editor .NET konvertieren: Eine Schritt‑für‑Schritt‑Anleitung](/editor/net/document-saving/convert-word-to-html-groupdocs-editor-dotnet/)
- [Effizientes Dokumenten‑Editing mit GroupDocs.Editor .NET: HTML in bearbeitbare Dokumente umwandeln](/editor/net/document-editing/edit-documents-groupdocs-editor-net/)