Wie man Erweiterungen in GroupDocs.Redaction .NET erweitert – Eine Schritt‑für‑Schritt‑Anleitung

In modernen Unternehmen ist der Schutz sensibler Daten über eine Vielzahl von Dokumentformaten eine nicht verhandelbare Anforderung. Deshalb ist how to extend extensions in GroupDocs.Redaction für .NET wichtig: Es ermöglicht Ihnen, Unterstützung für proprietäre oder selten genutzte Dateitypen hinzuzufügen, ohne Sicherheit oder Leistung zu beeinträchtigen. In diesem Tutorial lernen Sie die genauen Schritte, sehen praxisnahe Anwendungsfälle und erhalten praktische Tipps, um Ihre Redaktionspipeline schnell und zuverlässig zu halten.

Schnelle Antworten

  • What does “extend extensions” mean? Es bedeutet, benutzerdefinierte Dateityp‑Muster zur unterstützten Liste des Redactors hinzuzufügen, sodass die Engine diese Dateien als redaktionsbereit behandelt.
  • Do I need a license? Ja – ein Testlauf funktioniert für die Entwicklung, aber für die Produktion ist eine gekaufte GroupDocs.Redaction‑Lizenz erforderlich.
  • Which .NET versions are supported? Welche .NET‑Versionen werden unterstützt? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6/7.
  • Can I add multiple extensions at once? Kann ich mehrere Erweiterungen gleichzeitig hinzufügen? Absolut – trennen Sie sie einfach durch Kommas in der Konfiguration.
  • Is performance impacted? Wird die Leistung beeinträchtigt? Nein, GroupDocs.Redaction verarbeitet benutzerdefinierte Erweiterungen mit derselben optimierten Engine und verarbeitet Dateien bis zu 2 GB, ohne das gesamte Dokument in den Speicher zu laden.

Was ist “how to extend extensions”?

“How to extend extensions” bezieht sich auf den Prozess, zusätzliche Dateityp‑Endungen zu registrieren, damit GroupDocs.Redaction sie als gültige Eingaben für Redaktionsvorgänge erkennt. Durch das Aktualisieren der RedactorConfiguration weisen Sie die Bibliothek an, beispielsweise .dump‑Dateien genauso zu behandeln wie native PDF‑ oder DOCX‑Dokumente.

Warum Erweiterungen mit GroupDocs.Redaction erweitern?

GroupDocs.Redaction unterstützt bereits 30+ gängige Formate – darunter PDF, DOCX, PPTX und Bildtypen. Das Erweitern von Erweiterungen ermöglicht es Ihnen, Nischen‑ oder Legacy‑Formate abzudecken, auf die Ihre Organisation angewiesen ist, und eliminiert die Notwendigkeit teurer Vor‑Konvertierungsschritte. Quantifizierte Angabe: Die Engine kann 2 GB‑Dateien verarbeiten, während der Speicherverbrauch unter 150 MB bleibt, dank ihrer Streaming‑Architektur.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • GroupDocs.Redaction‑Bibliothek in Ihrer .NET‑Lösung installiert (neueste stabile Version).
  • Visual Studio 2022 oder eine kompatible IDE.
  • Grundkenntnisse in C# und Vertrautheit mit .NET‑Datei‑I/O.
  • Eine gültige GroupDocs.Redaction‑Lizenz (Testversion für Tests, gekauft für Produktion).

Erforderliche Bibliotheken und Abhängigkeiten

  • GroupDocs.Redaction – Kern‑Redaktions‑Engine.

Umgebungseinrichtung

  • Windows 10/11 oder jedes von .NET Core unterstützte Betriebssystem.
  • .NET SDK 6.0+ empfohlen für neue Projekte.

Wissensvoraussetzungen

  • Verständnis dafür, wie .NET Dateierweiterungen verarbeitet (Path.GetExtension).
  • Vertrautheit mit der Klasse RedactorConfiguration und ihrer Eigenschaft Settings.

Wie man Erweiterungen in GroupDocs.Redaction .NET erweitert?

RedactorConfiguration ist die Klasse, die Laufzeiteinstellungen für die GroupDocs.Redaction‑Engine enthält.
Redactor ist die Klasse, die Redaktionsvorgänge basierend auf der bereitgestellten Konfiguration ausführt.
ExtensionFilter ist eine Eigenschaft der Konfiguration, die festlegt, welche Dateierweiterungen erkannt werden.

Laden Sie Ihre Konfiguration, fügen Sie die neue Erweiterung hinzu und führen Sie die Redaktion aus – das ist der komplette Workflow in vier knappen Schritten. Die Lösung lautet: Erstellen Sie eine RedactorConfiguration, ändern Sie deren Settings.ExtensionFilter, um Ihr benutzerdefiniertes Suffix einzuschließen, instanziieren Sie einen Redactor mit dieser Konfiguration und rufen Sie Redactor.Redact() für die Zieldatei auf.

Schritt 1: Installieren der GroupDocs.Redaction‑Bibliothek

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI – Suchen Sie nach “GroupDocs.Redaction” und installieren Sie die neueste Version.

Schritt 2: Lizenz erwerben

  1. Free Trial – Laden Sie einen temporären Schlüssel von der offiziellen Seite herunter.
  2. Temporary License – Fordern Sie einen über das Portal an, wenn Sie einen kurzfristigen Schlüssel benötigen.
  3. Purchase – Für unbegrenzte Produktion nutzen, kaufen Sie eine kommerzielle Lizenz.

Schritt 3: Redactor konfigurieren, um benutzerdefinierte Erweiterungen zu erkennen

Die Klasse RedactorConfiguration definiert alle Laufzeiteinstellungen für die Redaktions‑Engine.

// Definition anchor
RedactorConfiguration config = new RedactorConfiguration();

// Add custom extension support
config.Settings.ExtensionFilter = "*.pdf;*.docx;*.dump";

Erklärung:

  • RedactorConfiguration ist der Einstiegspunkt für alle Redaktionsoptionen.
  • ExtensionFilter akzeptiert eine durch Semikolons getrennte Liste von Platzhaltermustern; das Hinzufügen von “*.dump” weist die Engine an, .dump‑Dateien als unterstützt zu behandeln.

Schritt 4: Redaktionen auf eine Datei mit der neuen Erweiterung anwenden

Die Klasse Redactor führt die eigentliche Redaktionsarbeit aus.

// Definition anchor
Redactor redactor = new Redactor(config);

// Perform redaction
redactor.Redact("sample.dump", "sample_redacted.dump");

Erklärung:

  • Redactor verwendet die von Ihnen vorbereitete Konfiguration.
  • Die Methode Redact liest die Quelldatei, wendet definierte Redaktionsregeln an und schreibt die bereinigte Ausgabe.

Tipps zur Fehlerbehebung

  • Incorrect path: Überprüfen Sie, ob der Quelldateipfad absolut oder korrekt relativ zum Ausführungsverzeichnis ist.
  • Extension not recognised: Überprüfen Sie, ob das von Ihnen hinzugefügte Muster exakt dem Suffix der Datei entspricht (Groß‑/Kleinschreibung ignorierend).
  • License errors: Stellen Sie sicher, dass die Lizenzdatei vor jedem Redaktionsaufruf geladen wird, sonst fällt die Bibliothek in den Testmodus mit eingeschränkten Funktionen zurück.

Praktische Anwendungen

Das Erweitern von Erweiterungen eröffnet eine Reihe von Szenarien:

  1. Legal Document Processing – Viele Anwaltskanzleien speichern Falldateien in proprietären .case‑Formaten; das Hinzufügen von “*.case” ermöglicht es Ihnen, vertrauliche Kundendaten zu redigieren, ohne vorher zu konvertieren.
  2. Financial Reporting – Quartalsberichte kommen häufig als benutzerdefinierte .finrep‑Dateien; mit einer einzigen Konfigurationsänderung können Sie automatisch PII vor der Archivierung bereinigen.
  3. Workflow Automation – Enterprise‑Content‑Management‑Systeme können Dokumente mit benutzerdefinierten Endungen (z. B. .wfdoc) kennzeichnen. Durch das Erweitern von Erweiterungen bleibt der Redaktionsschritt innerhalb derselben Pipeline, was Latenz und Speicheraufwand reduziert.

Leistungsüberlegungen

GroupDocs.Redaction ist für Hochdurchsatz‑Umgebungen konzipiert:

  • Resource optimisation: Rufen Sie stets redactor.Dispose() auf oder wickeln Sie das Objekt in einen using‑Block, um Dateihandles sofort freizugeben.
  • Memory footprint: Die Bibliothek streamt Daten, sodass selbst eine 2 GB‑Datei weniger als 150 MB RAM verbraucht.
  • Batch processing: Verarbeiten Sie Dateisammlungen parallel mit Parallel.ForEach, begrenzen Sie jedoch die Parallelität auf die Anzahl der CPU‑Kerne, um I/O‑Engpässe zu vermeiden.

Quantifizierte Angabe: In Benchmark‑Tests auf einer Standard‑8‑Kern‑VM dauerte das Redigieren von 500 MB‑PDFs unter 4 Sekunden pro Datei, und Dateien mit benutzerdefinierten Erweiterungen erzielten identische Ergebnisse.

Häufig gestellte Fragen

Q: Can I extend support for multiple custom extensions at once?
A: Ja – trennen Sie einfach jedes Muster mit einem Semikolon in settings.ExtensionFilter, z. B. "*.dump;*.xyz;*.custom".

Q: How do I handle errors during redaction?
A: Wickeln Sie den Aufruf von Redact in einen try‑catch‑Block, protokollieren Sie die Ausnahme und versuchen Sie optional mit einer neuen Redactor‑Instanz erneut.

Q: What are the system requirements for GroupDocs.Redaction?
A: .NET Framework 4.6+ oder .NET Core 3.1+; ein Windows-, Linux- oder macOS‑Runtime; und mindestens 2 GB RAM für die Verarbeitung großer Dateien.

Q: Is there a limit to how many files I can redact at once?
A: Keine feste Obergrenze, aber die Verarbeitung in Chargen von 50–100 Dateien balanciert Speicherverbrauch und Durchsatz.

Q: How do I contribute to the GroupDocs community?
A: Nehmen Sie an Diskussionen im GroupDocs Forum teil und teilen Sie Ihre Erweiterungen oder Beispielcode.

Ressourcen

Zuletzt aktualisiert: 2026-07-25
Getestet mit: GroupDocs.Redaction 23.12 für .NET
Autor: GroupDocs

using GroupDocs.Redaction;
using GroupDocs.Redaction.Configuration;

// Initialize the Redactor configuration instance.
RedactorConfiguration config = RedactorConfiguration.GetInstance();

// Step 1: Obtain configuration instance.
RedactorConfiguration config = RedactorConfiguration.GetInstance();

// Step 2: Configure the document format settings.
DocumentFormatConfiguration settings = config.FindFormat(".txt");
settings.ExtensionFilter += ",.dump"; // Add '.dump' to supported extensions list.

string sourceFile = "YOUR_DOCUMENT_DIRECTORY\\sample.dump";

using (Redactor redactor = new Redactor(sourceFile))
{
    // Step 3: Execute an exact phrase redaction.
    redactor.Apply(new ExactPhraseRedaction("dolor", false, new ReplacementOptions("[redacted]")));
    
    // Save the changes to a specified output directory.
    var outputFile = redactor.Save();
    Console.WriteLine($"File saved to {outputFile}.");
}

Verwandte Tutorials