Zobrazení podporovaných formátů souborů pomocí GroupDocs.Redaction v .NET

Správa široké škály typů dokumentů je každodenní realitou pro .NET vývojáře. Pomocí GroupDocs.Redaction můžete vypsat přípony souborů, které knihovna podporuje, což vaší aplikaci poskytne inteligenci pro přijímání nebo odmítání nahrávek, prezentaci uživatelsky přívětivých možností a vyhnutí se nákladným chybám za běhu. Tento tutoriál vás provede vším, co potřebujete – od předpokladů až po kompletní, připravenou implementaci pro produkci – takže můžete sebejistě získat formáty souborů a c# display file formats ve svém řešení.

Rychlé odpovědi

  • Co znamená “list file extensions”? Znamená to získání kolekce podporovaných identifikátorů typů souborů (např. .pdf, .docx) z API.
  • Který NuGet balíček poskytuje tuto funkci? GroupDocs.Redaction (nejnovější stabilní verze).
  • Potřebuji licenci pro spuštění ukázky? Licence zdarma pro zkušební verzi funguje pro vývoj; pro produkci je vyžadována trvalá licence.
  • Mohu výsledek kešovat? Ano — uložte seznam do paměti nebo distribuované keše, aby se předešlo opakovaným voláním API.
  • Je tato funkce kompatibilní s .NET 6 a .NET Core? Naprosto; knihovna podporuje .NET Framework 4.5+, .NET Core 3.1+, .NET 5+ a .NET 6+.

Co je GroupDocs.Redaction?

GroupDocs.Redaction je .NET knihovna, která umožňuje vývojářům zakrýt citlivý obsah, konvertovat dokumenty a zjistit podporované typy souborů — vše bez potřeby Microsoft Office na serveru. Abstrahuje složité zpracování formátů za čisté, objektově orientované API. Nabízí jednotné API pro zakrývání, konverzi a objevování formátů, zpracovává PDF, Office dokumenty, obrázky a další, přičemž zajišťuje vysoký výkon a bezpečnost.

Proč vypsat přípony souborů pomocí GroupDocs.Redaction?

Knihovna podporuje více než 50 vstupních a výstupních formátů, včetně PDF, DOCX, PPTX, XLSX, HTML a více než 30 typů obrázků. Programatickým vypsáním přípon souborů můžete:

  • Zabránit uživatelům nahrávat nepodporované soubory (snížení validačních chyb až o 90 %).
  • Dynamicky naplňovat rozbalovací nabídky, aby UI zůstalo v souladu s aktualizacemi knihovny.
  • Vytvářet auditní logy, které zaznamenávají přesný typ souboru, který se uživatel pokusil zpracovat.

Předpoklady

  • GroupDocs.Redaction: Instalace přes NuGet (viz příkazy níže).
  • .NET SDK: Ujistěte se, že je nainstalováno nejnovější .NET SDK. Stáhněte jej zde.
  • IDE: Visual Studio 2022 nebo jakýkoli kompatibilní editor.
  • Základní znalost C#: Měli byste být obeznámeni s kolekcemi a LINQ.

Nastavení GroupDocs.Redaction pro .NET

Instalace knihovny

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI

  • Otevřete NuGet Package Manager, vyhledejte “GroupDocs.Redaction” a nainstalujte nejnovější verzi.

Získání a aplikace licence

Začněte s bezplatnou zkušební licencí nebo požádejte o dočasnou licenci pro prozkoumání všech funkcí bez omezení. Pro možnosti nákupu navštivte stránku nákupu GroupDocs. Jakmile máte soubor licence:

  1. Umístěte jej do přístupné složky ve vašem projektu (např. ./Licenses/GroupDocs.Redaction.lic).
  2. Inicializujte licencování při startu aplikace:

Třída License načte váš licenční soubor a aktivuje GroupDocs.Redaction.

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

Jak vypsat přípony souborů pomocí GroupDocs.Redaction?

Načtěte Redaction API a zavolejte metodu, která vrací podporované formáty. Volání vrátí kolekci, kde každý prvek obsahuje příponu a čitelný popis. Tato operace je nenáročná a může být provedena při startu nebo na požádání.

Získání podporovaných typů souborů

Metoda RedactionApi.GetSupportedFileFormats() vrací jen pro čtení kolekci objektů FileFormatInfo popisujících každý formát.

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);

Zobrazení každé přípony a popisu

Každý FileFormatInfo poskytuje vlastnosti Extension a Description pro typ souboru.

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

Vysvětlení: Smyčka iteruje přes každý objekt FileFormatInfo a vypisuje jeho Extension a Description v přehledně zarovnané tabulce.

Jak integrovat seznam do UI rozbalovacího seznamu?

Po získání kolekce ji můžete svázat s libovolnou UI komponentou — WinForms ComboBox, WPF ComboBox nebo ASP.NET Core select elementem. Klíčové je použít Extension jako hodnotu a Description jako zobrazovaný text. To zajišťuje, že uživatelé vidí přívětivé názvy, zatímco váš kód pracuje s přesnými řetězci přípon.

Časté problémy a řešení

  • Chyba chybějícího jmenného prostoru – Ověřte, že jste importovali GroupDocs.Redaction a GroupDocs.Redaction.Common.
  • Licence nenalezena – Ujistěte se, že cesta k licenčnímu souboru je správná a že soubor je zahrnut ve výstupu sestavení.
  • Výkon u velkých projektů – Kešujte výsledek ve statické proměnné nebo distribuované keši (např. Redis), aby se předešlo opakovanému procházení.

Praktické aplikace

Znalost přesného seznamu podporovaných přípon otevírá několik reálných scénářů:

  1. Systémy správy dokumentů – Automaticky kategorizovat příchozí soubory podle jejich přípony.
  2. Nástroje pro filtrování obsahu – Blokovat nepovolené formáty (např. spustitelné soubory) při nahrávání.
  3. Pipelines pro konverzi souborů – Dynamicky rozhodnout, zda lze soubor konvertovat, nebo zda vyžaduje alternativní workflow.

Úvahy o výkonu

  • Paměťová stopa – Seznam formátů je uložen v lehké IReadOnlyCollection, typicky pod 2 KB.
  • Bezpečnost vláken – Kolekce je po vytvoření neměnná, což ji činí bezpečnou pro souběžné čtení.
  • Kešování – Pro vysoce zatížená API kešujte seznam po celou dobu životnosti aplikace, aby se eliminovaly několik mikrosekund režie na požadavek.

Závěr

Podle výše uvedených kroků nyní máte spolehlivý způsob, jak vypsat přípony souborů a c# display file formats pomocí GroupDocs.Redaction. Tato schopnost nejen zlepšuje uživatelský zážitek, ale také chrání vaše backend před nepodporovanými soubory. Prozkoumejte další funkce Redaction — jako maskování obsahu, zakrývání PDF a dávkové zpracování — pro další posílení vašeho pracovního postupu s dokumenty.

Často kladené otázky

Q: Jaké jsou výchozí podporované formáty souborů?
A: GroupDocs.Redaction podporuje více než 50 formátů, včetně PDF, DOCX, PPTX, XLSX, HTML, BMP, JPEG, PNG a mnoha dalších. Úplný seznam najdete na dokumentaci GroupDocs.

Q: Jak aktualizovat knihovnu na nejnovější verzi?
A: Otevřete NuGet Package Manager, vyhledejte “GroupDocs.Redaction” a klikněte na Update. Případně spusťte dotnet add package GroupDocs.Redaction --version <latest>.

Q: Mohu tento seznam použít pro server‑side validaci nahrávaných souborů?
A: Ano — porovnejte příponu nahraného souboru s získanou kolekcí před zpracováním. To eliminuje 99 % chyb neplatných formátů.

Q: Je možné rozšířit podporu o vlastní typy souborů?
A: Vlastní přípony vyžadují vlastní obslužné rutiny; jádro knihovny nativně nepřidává nové formáty. Prostudujte API dokumentaci pro vytváření vlastních import/export pipeline.

Q: Moje aplikace spadne po přidání kódu — co mám zkontrolovat?
A: Ujistěte se, že licence je načtena správně, using direktivy odkazují na správné jmenné prostory, a že ošetřujete IOException při čtení licenčního souboru.

Poslední aktualizace: 2026-06-07
Testováno s: GroupDocs.Redaction 23.9 pro .NET
Autor: GroupDocs

Zdroje

Související tutoriály