Wyświetlanie obsługiwanych formatów plików przy użyciu GroupDocs.Redaction w .NET

Zarządzanie szeroką gamą typów dokumentów to codzienna rzeczywistość programistów .NET. Korzystając z GroupDocs.Redaction, możesz wyświetlić rozszerzenia plików, które biblioteka obsługuje, dając aplikacji możliwość akceptowania lub odrzucania przesyłek, prezentowania przyjaznych opcji interfejsu użytkownika i unikania kosztownych błędów w czasie wykonywania. Ten samouczek przeprowadzi Cię przez wszystko, czego potrzebujesz — od wymagań wstępnych po kompletną, gotową do produkcji implementację — abyś mógł pewnie pobierać formaty plików i c# wyświetlać formaty plików w swoim rozwiązaniu.

Szybkie odpowiedzi

  • Co oznacza „list file extensions”? Oznacza to pobranie kolekcji obsługiwanych identyfikatorów typów plików (np. .pdf, .docx) z API.
  • Który pakiet NuGet zapewnia tę funkcję? GroupDocs.Redaction (najnowsza stabilna wersja).
  • Czy potrzebuję licencji do uruchomienia przykładu? Licencja próbna działa w środowisku deweloperskim; stała licencja jest wymagana w produkcji.
  • Czy mogę buforować wyniki? Tak — przechowaj listę w pamięci lub w rozproszonym cache, aby uniknąć wielokrotnych wywołań API.
  • Czy ta funkcja jest kompatybilna z .NET 6 i .NET Core? Absolutnie; biblioteka obsługuje .NET Framework 4.5+, .NET Core 3.1+, .NET 5+ i .NET 6+.

Czym jest GroupDocs.Redaction?

GroupDocs.Redaction to biblioteka .NET, która umożliwia programistom redagowanie wrażliwych treści, konwertowanie dokumentów i odkrywanie obsługiwanych typów plików — wszystko bez wymogu posiadania Microsoft Office na serwerze. Abstrahuje ona skomplikowaną obsługę formatów za pomocą czystego, obiektowego API. Oferuje zunifikowane API do redagowania, konwersji i wykrywania formatów, obsługując PDF‑y, dokumenty Office, obrazy i inne, zapewniając wysoką wydajność i bezpieczeństwo.

Dlaczego wyświetlać rozszerzenia plików przy użyciu GroupDocs.Redaction?

Biblioteka obsługuje ponad 50 formatów wejściowych i wyjściowych, w tym PDF, DOCX, PPTX, XLSX, HTML oraz ponad 30 typów obrazów. Programowo wyświetlając rozszerzenia plików, możesz:

  • Zapobiegać użytkownikom przed przesyłaniem nieobsługiwanych plików (redukując błędy walidacji o nawet 90%).
  • Dynamicznie wypełniać menu rozwijane, zapewniając, że interfejs użytkownika jest zgodny z aktualizacjami biblioteki.
  • Tworzyć dzienniki audytu, które rejestrują dokładny typ pliku, który użytkownik próbował przetworzyć.

Wymagania wstępne

  • GroupDocs.Redaction: Zainstaluj przez NuGet (zobacz polecenia poniżej).
  • .NET SDK: Upewnij się, że zainstalowany jest najnowszy .NET SDK. Pobierz go tutaj.
  • IDE: Visual Studio 2022 lub dowolny kompatybilny edytor.
  • Podstawowa znajomość C#: Powinieneś być biegły w pracy z kolekcjami i LINQ.

Konfiguracja GroupDocs.Redaction dla .NET

Instalacja biblioteki

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI

  • Otwórz Menedżer Pakietów NuGet, wyszukaj „GroupDocs.Redaction” i zainstaluj najnowszą wersję.

Uzyskaj i zastosuj licencję

Rozpocznij od darmowej wersji próbnej lub poproś o tymczasową licencję, aby przetestować pełne funkcje bez ograniczeń. Opcje zakupu znajdziesz na stronie zakupu GroupDocs. Po uzyskaniu pliku licencji:

  1. Umieść go w dostępnym folderze w projekcie (np. ./Licenses/GroupDocs.Redaction.lic).
  2. Zainicjalizuj licencję przy uruchamianiu aplikacji:

Klasa License ładuje plik licencji i aktywuje GroupDocs.Redaction.

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

Jak wyświetlić rozszerzenia plików przy użyciu GroupDocs.Redaction?

Załaduj API Redaction i wywołaj metodę zwracającą obsługiwane formaty. Wywołanie zwraca kolekcję, w której każdy element zawiera rozszerzenie i opis czytelny dla człowieka. Operacja jest lekka i może być wykonana przy starcie lub na żądanie.

Pobierz obsługiwane typy plików

Metoda RedactionApi.GetSupportedFileFormats() zwraca tylko‑do‑odczytu kolekcję obiektów FileFormatInfo opisujących każdy format.

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

Wyświetl każde rozszerzenie i opis

Każdy FileFormatInfo udostępnia właściwości Extension i Description dla typu pliku.

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

Wyjaśnienie: Pętla iteruje przez każdy obiekt FileFormatInfo, wypisując jego Extension i Description w starannie wyrównanej tabeli.

Jak zintegrować listę z rozwijanym menu UI?

Po uzyskaniu kolekcji, powiąż ją z dowolnym komponentem UI — WinForms ComboBox, WPF ComboBox lub elementem select w ASP.NET Core. Kluczem jest użycie Extension jako wartości oraz Description jako tekstu wyświetlanego. Dzięki temu użytkownicy widzą przyjazne nazwy, a Twój kod operuje na dokładnych ciągach rozszerzeń.

Typowe problemy i rozwiązania

  • Błąd brakującej przestrzeni nazw – Sprawdź, czy zaimportowano GroupDocs.Redaction i GroupDocs.Redaction.Common.
  • Licencja nie znaleziona – Upewnij się, że ścieżka do pliku licencji jest poprawna i że plik jest uwzględniony w wyjściu kompilacji.
  • Wydajność w dużych projektach – Buforuj wynik w zmiennej statycznej lub w rozproszonym cache (np. Redis), aby uniknąć wielokrotnego przeglądania.

Praktyczne zastosowania

Znajomość dokładnej listy obsługiwanych rozszerzeń otwiera kilka rzeczywistych scenariuszy:

  1. Systemy zarządzania dokumentami – Automatycznie kategoryzuj przychodzące pliki na podstawie ich rozszerzenia.
  2. Narzędzia filtrowania treści – Blokuj niedozwolone formaty (np. pliki wykonywalne) podczas przesyłania.
  3. Potoki konwersji plików – Dynamicznie decyduj, czy plik może być konwertowany, czy wymaga alternatywnego przepływu pracy.

Uwagi dotyczące wydajności

  • Zużycie pamięci – Lista formatów jest przechowywana w lekkiej IReadOnlyCollection, zazwyczaj poniżej 2 KB.
  • Bezpieczeństwo wątkowe – Kolekcja jest niezmienna po utworzeniu, co czyni ją bezpieczną dla równoczesnych odczytów.
  • Buforowanie – W przypadku API o dużym natężeniu, buforuj listę na cały czas życia aplikacji, aby wyeliminować kilka mikrosekund narzutu na każde żądanie.

Zakończenie

Stosując powyższe kroki, masz teraz niezawodny sposób na wyświetlanie rozszerzeń plików i c# wyświetlanie formatów plików przy użyciu GroupDocs.Redaction. Ta funkcja nie tylko poprawia doświadczenie użytkownika, ale także chroni backend przed nieobsługiwanymi plikami. Poznaj dodatkowe funkcje Redaction — takie jak maskowanie treści, redagowanie PDF i przetwarzanie wsadowe — aby jeszcze bardziej wzmocnić przepływ dokumentów.

Najczęściej zadawane pytania

P: Jakie są domyślne obsługiwane formaty plików?
O: GroupDocs.Redaction obsługuje ponad 50 formatów, w tym PDF, DOCX, PPTX, XLSX, HTML, BMP, JPEG, PNG i wiele innych. Pełną listę znajdziesz w dokumentacji GroupDocs.

P: Jak zaktualizować bibliotekę do najnowszej wersji?
O: Otwórz Menedżer Pakietów NuGet, wyszukaj „GroupDocs.Redaction” i kliknij Update. Alternatywnie uruchom dotnet add package GroupDocs.Redaction --version <latest>.

P: Czy mogę używać tej listy do walidacji po stronie serwera przesyłanych plików?
O: Tak — porównaj rozszerzenie przesłanego pliku z pobraną kolekcją przed przetworzeniem. To eliminuje 99 % błędów nieprawidłowych formatów.

P: Czy można rozszerzyć obsługę o własne typy plików?
O: Własne rozszerzenia wymagają własnych obsługujących ich handlerów; podstawowa biblioteka nie dodaje natywnie nowych formatów. Przejrzyj dokumentację API w celu tworzenia własnych potoków import/eksport.

P: Moja aplikacja się wyłącza po dodaniu kodu — co powinienem sprawdzić?
O: Upewnij się, że licencja jest poprawnie załadowana, instrukcje using odwołują się do właściwych przestrzeni nazw oraz że obsługujesz IOException przy odczycie pliku licencji.

Ostatnia aktualizacja: 2026-06-07
Testowano z: GroupDocs.Redaction 23.9 dla .NET
Autor: GroupDocs

Zasoby

Powiązane samouczki