Anzeige unterstützter Dateiformate mit GroupDocs.Redaction in .NET

Die Verwaltung einer großen Vielfalt von Dokumenttypen ist für .NET‑Entwickler Alltag. Mit GroupDocs.Redaction können Sie Dateierweiterungen auflisten, die die Bibliothek unterstützt, und Ihrer Anwendung die Intelligenz verleihen, Uploads zu akzeptieren oder abzulehnen, benutzerfreundliche UI‑Optionen anzuzeigen und kostspielige Laufzeitfehler zu vermeiden. Dieses Tutorial führt Sie durch alles, was Sie benötigen – von den Voraussetzungen bis zu einer vollständigen, produktionsbereiten Implementierung – damit Sie sicher Dateiformate abrufen und c# display file formats in Ihrer Lösung verwenden können.

Schnelle Antworten

  • Was bedeutet „list file extensions“? Es bedeutet, die Sammlung unterstützter Dateityp‑Bezeichner (z. B. .pdf, .docx) über die API abzurufen.
  • Welches NuGet‑Paket stellt diese Funktion bereit? GroupDocs.Redaction (neueste stabile Version).
  • Benötige ich eine Lizenz, um das Beispiel auszuführen? Eine kostenlose Testlizenz funktioniert für die Entwicklung; für die Produktion ist eine permanente Lizenz erforderlich.
  • Kann ich die Ergebnisse zwischenspeichern? Ja – speichern Sie die Liste im Speicher oder in einem verteilten Cache, um wiederholte API‑Aufrufe zu vermeiden.
  • Ist diese Funktion mit .NET 6 und .NET Core kompatibel? Absolut; die Bibliothek unterstützt .NET Framework 4.5+, .NET Core 3.1+, .NET 5+ und .NET 6+.

Was ist GroupDocs.Redaction?

GroupDocs.Redaction ist eine .NET‑Bibliothek, die Entwicklern ermöglicht, sensible Inhalte zu schwärzen, Dokumente zu konvertieren und unterstützte Dateitypen zu ermitteln – und das alles, ohne Microsoft Office auf dem Server zu benötigen. Sie abstrahiert die komplexe Formatbehandlung hinter einer sauberen, objektorientierten API. Sie bietet eine einheitliche API für Schwärzung, Konvertierung und Format‑Erkennung, verarbeitet PDFs, Office‑Dokumente, Bilder und mehr, und gewährleistet dabei hohe Leistung und Sicherheit.

Warum Dateierweiterungen mit GroupDocs.Redaction auflisten?

Die Bibliothek unterstützt mehr als 50 Eingabe‑ und Ausgabeformate, darunter PDF, DOCX, PPTX, XLSX, HTML und über 30 Bildtypen. Durch das programmgesteuerte Auflisten von Dateierweiterungen können Sie:

  • Verhindern, dass Benutzer nicht unterstützte Dateien hochladen (Reduzierung von Validierungsfehlern um bis zu 90 %).
  • Dropdown‑Menüs dynamisch füllen, sodass die UI mit Bibliotheks‑Updates synchron bleibt.
  • Audit‑Logs erstellen, die den genauen Dateityp protokollieren, den ein Benutzer zu verarbeiten versucht hat.

Voraussetzungen

  • GroupDocs.Redaction: Installation über NuGet (siehe die Befehle unten).
  • .NET SDK: Stellen Sie sicher, dass das neueste .NET SDK installiert ist. Laden Sie es hier herunter.
  • IDE: Visual Studio 2022 oder ein kompatibler Editor.
  • Grundlegende C#‑Kenntnisse: Sie sollten mit Collections und LINQ vertraut sein.

Einrichtung von GroupDocs.Redaction für .NET

Bibliothek installieren

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI

  • Öffnen Sie den NuGet Package Manager, suchen Sie nach „GroupDocs.Redaction“ und installieren Sie die neueste Version.

Lizenz erwerben und anwenden

Beginnen Sie mit einer kostenlosen Testversion oder fordern Sie eine temporäre Lizenz an, um alle Funktionen ohne Einschränkungen zu testen. Für Kaufoptionen besuchen Sie die Kaufseite von GroupDocs. Sobald Sie Ihre Lizenzdatei haben:

  1. Legen Sie sie in einen zugänglichen Ordner innerhalb Ihres Projekts (z. B. ./Licenses/GroupDocs.Redaction.lic).
  2. Initialisieren Sie die Lizenzierung beim Anwendungsstart:

Die Klasse License lädt Ihre Lizenzdatei und aktiviert GroupDocs.Redaction.

   using GroupDocs.Redaction.License;
   
   License lic = new License();
   lic.SetLicense("path/to/your/license/file");

Wie listet man Dateierweiterungen mit GroupDocs.Redaction auf?

Laden Sie die Redaction‑API und rufen Sie die Methode auf, die die unterstützten Formate zurückgibt. Der Aufruf liefert eine Sammlung, bei der jedes Element eine Erweiterung und eine menschenlesbare Beschreibung enthält. Dieser Vorgang ist leichtgewichtig und kann beim Start oder bei Bedarf ausgeführt werden.

Unterstützte Dateitypen abrufen

Die Methode RedactionApi.GetSupportedFileFormats() gibt eine schreibgeschützte Sammlung von FileFormatInfo‑Objekten zurück, die jedes Format beschreiben.

using GroupDocs.Search.Results;
using System;
using System.Collections.Generic;

// Using LINQ to order the supported file formats by their extensions.
IEnumerable<FileType> supportedFileTypes = FileType.GetSupportedFileTypes()
    .OrderBy(ft => ft.Extension);

Jede Erweiterung und Beschreibung anzeigen

Jedes FileFormatInfo stellt die Eigenschaften Extension und Description für einen Dateityp bereit.

foreach (FileType fileType in supportedFileTypes)
{
    Console.WriteLine(fileType.Extension.PadRight(8) + " - " + fileType.Description);
}

Erklärung: Die Schleife iteriert über jedes FileFormatInfo‑Objekt und gibt dessen Extension und Description in einer ordentlich ausgerichteten Tabelle aus.

Wie integriert man die Liste in ein UI‑Dropdown?

Nachdem Sie die Sammlung haben, binden Sie sie an jede UI‑Komponente – WinForms ComboBox, WPF ComboBox oder ASP.NET Core select‑Element. Der Schlüssel ist, die Extension als Wert und die Description als Anzeigetext zu verwenden. So sehen Benutzer freundliche Namen, während Ihr Code mit den genauen Erweiterungszeichenketten arbeitet.

Häufige Probleme und Lösungen

  • Fehler: Fehlender Namespace – Stellen Sie sicher, dass Sie GroupDocs.Redaction und GroupDocs.Redaction.Common importiert haben.
  • Lizenz nicht gefunden – Vergewissern Sie sich, dass der Pfad zur Lizenzdatei korrekt ist und die Datei im Build‑Ausgabeordner enthalten ist.
  • Leistung bei großen Projekten – Zwischenspeichern des Ergebnisses in einer statischen Variable oder einem verteilten Cache (z. B. Redis), um wiederholte Aufzählungen zu vermeiden.

Praktische Anwendungen

Das genaue Wissen über die unterstützten Erweiterungen eröffnet mehrere praxisnahe Szenarien:

  1. Dokumenten‑Management‑Systeme – Eingehende Dateien automatisch anhand ihrer Erweiterung kategorisieren.
  2. Content‑Filtering‑Tools – Nicht zulässige Formate (z. B. ausführbare Dateien) beim Hochladen blockieren.
  3. Dateikonvertierungs‑Pipelines – Dynamisch entscheiden, ob eine Datei konvertiert werden kann oder ein Ausweich‑Workflow nötig ist.

Leistungsüberlegungen

  • Speicherverbrauch – Die Formatliste wird in einer leichten IReadOnlyCollection gespeichert, typischerweise unter 2 KB.
  • Thread‑Sicherheit – Die Sammlung ist nach der Erstellung unveränderlich und somit sicher für gleichzeitige Lesevorgänge.
  • Caching – Für stark frequentierte APIs die Liste für die Lebensdauer der Anwendung zwischenspeichern, um die wenigen Mikrosekunden Overhead pro Anfrage zu eliminieren.

Fazit

Indem Sie die obigen Schritte befolgt haben, verfügen Sie nun über eine zuverlässige Methode, Dateierweiterungen aufzulisten und c# display file formats mit GroupDocs.Redaction zu verwenden. Diese Fähigkeit verbessert nicht nur die Benutzererfahrung, sondern schützt Ihr Backend vor nicht unterstützten Dateien. Erkunden Sie weitere Redaction‑Funktionen – wie Content‑Maskierung, PDF‑Redaktion und Batch‑Verarbeitung – um Ihren Dokumenten‑Workflow weiter zu stärken.

Häufig gestellte Fragen

Q: Was sind die standardmäßig unterstützten Dateiformate?
A: GroupDocs.Redaction unterstützt mehr als 50 Formate, darunter PDF, DOCX, PPTX, XLSX, HTML, BMP, JPEG, PNG und viele weitere. Die vollständige Liste finden Sie in der GroupDocs‑Dokumentation.

Q: Wie aktualisiere ich die Bibliothek auf die neueste Version?
A: Öffnen Sie den NuGet Package Manager, suchen Sie nach „GroupDocs.Redaction“ und klicken Sie auf Update. Alternativ führen Sie dotnet add package GroupDocs.Redaction --version <latest> aus.

Q: Kann ich diese Liste für serverseitige Validierung hochgeladener Dateien verwenden?
A: Ja – vergleichen Sie die Erweiterung der hochgeladenen Datei mit der abgerufenen Sammlung, bevor Sie sie verarbeiten. Das eliminiert 99 % der Fehler wegen ungültiger Formate.

Q: Ist es möglich, die Unterstützung für benutzerdefinierte Dateitypen zu erweitern?
A: Benutzerdefinierte Erweiterungen erfordern eigene Handler; die Kernbibliothek fügt nicht nativ neue Formate hinzu. Prüfen Sie die API‑Dokumentation für das Erstellen benutzerdefinierter Import/Export‑Pipelines.

Q: Meine Anwendung stürzt nach dem Hinzufügen des Codes ab – was sollte ich überprüfen?
A: Stellen Sie sicher, dass die Lizenz korrekt geladen wird, die using‑Anweisungen die richtigen Namespaces referenzieren und dass Sie IOException beim Lesen der Lizenzdatei behandeln.

Zuletzt aktualisiert: 2026-06-07
Getestet mit: GroupDocs.Redaction 23.9 for .NET
Autor: GroupDocs

Ressourcen

Verwandte Tutorials