Programmatisches Bearbeiten von Word-Dokumenten mit GroupDocs.Editor für .NET

Wenn Sie ein .NET‑Entwickler sind, der Word‑Dokumente programmgesteuert bearbeiten muss – sei es zum Ersetzen von Text, Konvertieren von Formaten oder Einbetten des Ergebnisses in einen Stream – ist GroupDocs.Editor für .NET eine robuste, einfach zu verwendende Bibliothek, die die Aufgabe erledigt. In diesem Tutorial führen wir Sie durch ein praxisnahes Beispiel, das das Laden einer DOCX‑Datei, das Bearbeiten ihres Inhalts, die Konvertierung des Ergebnisses nach RTF und das Speichern entweder auf dem Datenträger oder in einen Speicher‑Stream abdeckt.

Schnelle Antworten

  • Was kann ich bearbeiten? Word, PDF, HTML, RTF und viele weitere Formate.
  • Kann ich Text ersetzen? Ja – verwenden Sie einfache Zeichenketten‑Ersetzung oder fortgeschrittene DOM‑Manipulation.
  • Wie konvertiere ich PDF zu editierbar? Laden Sie das PDF mit Editor und bearbeiten Sie das erzeugte HTML.
  • Was ist der einfachste Weg, in einen Stream zu speichern? Verwenden Sie editor.Save(editableDoc, stream, options).
  • Brauche ich eine Lizenz? Eine temporäre oder vollständige Lizenz ist für den Produktionseinsatz erforderlich.

Was bedeutet programmgesteuertes Bearbeiten von Word‑Dokumenten?

Programmgesteuertes Bearbeiten eines Word‑Dokuments bedeutet, Code zu verwenden – anstatt einer Benutzeroberfläche – um eine Datei zu öffnen, ihren Inhalt (Text, Bilder, Formatvorlagen) zu ändern und die modifizierte Version wieder im Speicher abzulegen. Dieser Ansatz ermöglicht automatisierte Berichte, massenhafte Dokumenten‑Updates und die Erstellung benutzerdefinierter Inhalte.

Warum GroupDocs.Editor für .NET verwenden?

  • Formatflexibilität: Laden Sie DOCX, PDF, HTML, RTF usw. und speichern Sie in jedes unterstützte Format.
  • Keine Office‑Abhängigkeit: Funktioniert, ohne dass Microsoft Office auf dem Server installiert sein muss.
  • Stream‑freundlich: Ideal für Cloud‑Szenarien, bei denen Sie von Streams statt vom Dateisystem lesen/schreiben.
  • Umfangreiche API: Zugriff auf Bilder, Schriftarten, CSS und andere Ressourcen für ein vollwertiges Bearbeiten.

Voraussetzungen

Bevor wir in die Implementierung eintauchen, stellen Sie sicher, dass Sie Folgendes haben:

  • Visual Studio 2017 oder neuer.
  • .NET Framework 4.6.1 oder neuer.
  • GroupDocs.Editor für .NET – Sie können es von der Seite herunterladen .
  • Eine gültige Lizenz oder eine temporäre Lizenz von GroupDocs.

Namespaces importieren

Um GroupDocs.Editor für .NET zu verwenden, importieren Sie die erforderlichen Namespaces:

using System;
using System.IO;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;

In den folgenden Abschnitten werden wir den Arbeitsablauf in kleine Schritte aufteilen, damit Sie leicht folgen können.

Schritt 1: Pfad zur Eingabedatei ermitteln

Geben Sie den Speicherort der Word‑Datei an, die Sie bearbeiten möchten. In diesem Beispiel gehen wir von einer DOCX‑Datei namens Your Sample Document.docx aus.

string inputFilePath = "Your Sample Document.docx";

Schritt 2: Editor‑Objekt instanziieren

Erstellen Sie eine Editor‑Instanz, indem Sie den Eingabepfad übergeben. Dadurch wird das Dokument geladen und für die Bearbeitung vorbereitet.

using (GroupDocs.Editor.Editor editor = new Editor(inputFilePath))
{
    // Subsequent steps will be nested inside this block
}

Schritt 3: Dokument zum Bearbeiten öffnen

Holen Sie ein EditableDocument, das Ihnen Zugriff auf die HTML‑Darstellung des Dokuments und dessen Ressourcen gibt.

EditableDocument beforeEdit = editor.Edit();

Schritt 4: Dokumentinhalt und Ressourcen abrufen

Sie können das rohe HTML, Bilder, Schriftarten und CSS extrahieren. Das ist nützlich, wenn Sie das Markup direkt manipulieren müssen.

string content = beforeEdit.GetContent();
var images = beforeEdit.Images;
var fonts = beforeEdit.Fonts;
var stylesheets = beforeEdit.Css;

Schritt 4.1: Dokument als einzelnen Base64‑kodierten String erhalten

Wenn Sie einen einzelnen String bevorzugen, der alle eingebetteten Ressourcen enthält, rufen Sie GetEmbeddedHtml() auf.

string allEmbeddedInsideString = beforeEdit.GetEmbeddedHtml();

Schritt 4.2: Inhalt bearbeiten

Ersetzen wir das Wort Subtitle durch Edited subtitle, um eine einfache Text­ersetzung zu demonstrieren.

string allEmbeddedInsideStringEdited = allEmbeddedInsideString.Replace("Subtitle", "Edited subtitle");

Schritt 5: Neue EditableDocument‑Instanz erstellen

Nach der Bearbeitung des Markups verpacken Sie es wieder in ein EditableDocument‑Objekt.

EditableDocument afterEdit = EditableDocument.FromMarkup(allEmbeddedInsideStringEdited, null);

Schritt 6: Bearbeitetes Dokument speichern

Wir speichern das Ergebnis als RTF‑Datei und zeigen sowohl einen Dateisystem‑Pfad als auch eine Speicher‑Stream‑Option.

Schritt 6.1: Ausgabepfad vorbereiten

Legen Sie fest, wohin das RTF geschrieben werden soll.

string outputPath = Path.Combine("Output Directory Path", Path.GetFileNameWithoutExtension(inputFilePath) + ".rtf");

Schritt 6.2: Speicheroptionen vorbereiten

Wählen Sie das RTF‑Format über WordProcessingSaveOptions aus.

Options.WordProcessingSaveOptions saveOptions = new WordProcessingSaveOptions(WordProcessingFormats.Rtf);

Schritt 6.3: In Pfad speichern

Schreiben Sie das bearbeitete Dokument in das Dateisystem.

editor.Save(afterEdit, outputPath, saveOptions);

Schritt 6.4: In einen Stream speichern

Wenn Sie das Ergebnis im Speicher benötigen (z. B. zum Hochladen in Cloud‑Speicher), verwenden Sie einen MemoryStream.

using (MemoryStream ms = new MemoryStream())
{
    editor.Save(afterEdit, ms, saveOptions);
}

Schritt 7: Editor‑ und EditableDocument‑Instanzen freigeben

Ressourcen sofort freigeben, um Speicherlecks zu vermeiden.

beforeEdit.Dispose();
afterEdit.Dispose();
editor.Dispose();

Häufige Anwendungsfälle & Tipps

  • PDF in editierbar konvertieren: Laden Sie ein PDF mit Editor, bearbeiten Sie das erzeugte HTML und speichern Sie es anschließend wieder als PDF oder in ein anderes Format.
  • Text im Dokument ersetzen: Verwenden Sie string.Replace für einfache Fälle oder manipulieren Sie das DOM für komplexe Szenarien.
  • Word nach RTF konvertieren: Wie oben gezeigt, setzen Sie WordProcessingFormats.Rtf in den Speicheroptionen.
  • Dokument in einen Stream speichern: Ideal für Web‑APIs, die Dateien direkt an den Client zurückgeben.
  • Dokument zum Bearbeiten laden: Umwickeln Sie den Editor stets in einem using‑Block, um eine ordnungsgemäße Freigabe sicherzustellen.

Häufig gestellte Fragen

Q: Kann ich PDF‑Dateien mit GroupDocs.Editor für .NET bearbeiten?
A: Ja, GroupDocs.Editor unterstützt die Bearbeitung von PDFs, indem sie in eine Zwischendarstellung als HTML konvertiert werden.

Q: Wie erhalte ich eine temporäre Lizenz für GroupDocs.Editor für .NET?
A: Sie können eine temporäre Lizenz von der GroupDocs-Website erhalten.

Q: Welche Dateiformate werden von GroupDocs.Editor für .NET unterstützt?
A: DOCX, PDF, HTML, RTF und viele weitere Formate werden unterstützt.

Q: Ist es möglich, GroupDocs.Editor in Cloud‑Speicher zu integrieren?
A: Absolut – Sie können Streams von Azure Blob, Amazon S3, Google Cloud Storage usw. lesen/schreiben.

Q: Wo finde ich die Dokumentation für GroupDocs.Editor für .NET?
A: Die Dokumentation ist hier verfügbar.

Zuletzt aktualisiert: 2026-04-11
Getestet mit: GroupDocs.Editor 23.12 for .NET
Autor: GroupDocs