Jak rozszerzyć rozszerzenia w GroupDocs.Redaction .NET – Przewodnik krok po kroku

W nowoczesnych przedsiębiorstwach ochrona wrażliwych danych w szerokiej gamie formatów dokumentów jest wymogiem nie do negocjacji. Dlatego jak rozszerzyć rozszerzenia w GroupDocs.Redaction dla .NET ma znaczenie: pozwala dodać obsługę własnych lub rzadko używanych typów plików bez kompromisu w zakresie bezpieczeństwa czy wydajności. W tym samouczku poznasz dokładne kroki, zobaczysz rzeczywiste przypadki użycia i otrzymasz praktyczne wskazówki, aby utrzymać swoją linię redakcji szybką i niezawodną.

Szybkie odpowiedzi

• Co oznacza „rozszerzyć rozszerzenia”? Oznacza to dodanie własnych wzorców typów plików do listy obsługiwanej przez Redactor, tak aby silnik traktował te pliki jako gotowe do redakcji.
• Czy potrzebna jest licencja? Tak – wersja próbna działa w środowisku deweloperskim, ale produkcja wymaga zakupionej licencji GroupDocs.Redaction.
• Jakie wersje .NET są obsługiwane? .NET Framework 4.6+, .NET Core 3.1+, .NET 5/6/7.
• Czy mogę dodać wiele rozszerzeń jednocześnie? Oczywiście – wystarczy oddzielić je przecinkami w konfiguracji.
• Czy wydajność jest obniżona? Nie, GroupDocs.Redaction przetwarza własne rozszerzenia tym samym zoptymalizowanym silnikiem, obsługując pliki do 2 GB bez ładowania całego dokumentu do pamięci.

Co to jest „jak rozszerzyć rozszerzenia”?

„Jak rozszerzyć rozszerzenia” odnosi się do procesu rejestrowania dodatkowych przyrostków typów plików, aby GroupDocs.Redaction rozpoznawał je jako prawidłowe wejścia dla operacji redakcji. Aktualizując RedactorConfiguration, instruujesz bibliotekę, aby traktowała np. pliki .dump tak samo jak natywne dokumenty PDF lub DOCX.

Dlaczego rozszerzać rozszerzenia w GroupDocs.Redaction?

GroupDocs.Redaction już obsługuje ponad 30 popularnych formatów — w tym PDF, DOCX, PPTX i typy obrazów. Rozszerzanie rozszerzeń pozwala objąć niszowe lub starsze formaty, na których opiera się Twoja organizacja, eliminując potrzebę kosztownych kroków wstępnej konwersji. Kwantyfikowane stwierdzenie: silnik może przetwarzać pliki 2 GB, utrzymując zużycie pamięci poniżej 150 MB, dzięki architekturze strumieniowej.

Wymagania wstępne

Zanim rozpoczniesz, upewnij się, że masz następujące elementy:

• Bibliotekę GroupDocs.Redaction zainstalowaną w Twoim rozwiązaniu .NET (najnowsza stabilna wersja).
• Visual Studio 2022 lub dowolne kompatybilne IDE.
• Podstawową znajomość C# oraz obeznanie z operacjami I/O plików w .NET.
• Ważną licencję GroupDocs.Redaction (wersja próbna do testów, zakupiona do produkcji).

Wymagane biblioteki i zależności

• GroupDocs.Redaction – podstawowy silnik redakcji.

Konfiguracja środowiska

• Windows 10/11 lub dowolny system operacyjny obsługiwany przez .NET Core.
• .NET SDK 6.0+ zalecany dla nowych projektów.

Wymagania wiedzy

• Zrozumienie, jak .NET obsługuje rozszerzenia plików (Path.GetExtension).
• Znajomość klasy RedactorConfiguration oraz jej właściwości Settings.

Jak rozszerzyć rozszerzenia w GroupDocs.Redaction .NET?

RedactorConfiguration to klasa przechowująca ustawienia czasu wykonania dla silnika GroupDocs.Redaction.
Redactor to klasa wykonująca operacje redakcji na podstawie dostarczonej konfiguracji.
ExtensionFilter to właściwość konfiguracji określająca, które rozszerzenia plików są rozpoznawane.

Wczytaj swoją konfigurację, dodaj nowe rozszerzenie i uruchom redakcję – to pełny przepływ pracy w czterech zwięzłych krokach. Odpowiedź brzmi: utwórz RedactorConfiguration, zmodyfikuj jego Settings.ExtensionFilter, aby zawierał własny przyrostek, zainicjuj Redactor z tą konfiguracją i wywołaj Redactor.Redact() na docelowym pliku.

Krok 1: Zainstaluj bibliotekę GroupDocs.Redaction

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI – wyszukaj „GroupDocs.Redaction” i zainstaluj najnowszą wersję.

Krok 2: Uzyskaj licencję

1. Bezpłatna wersja próbna – Pobierz tymczasowy klucz ze strony oficjalnej.
2. Tymczasowa licencja – Zamów ją przez portal, jeśli potrzebujesz krótkoterminowego klucza.
3. Zakup – Aby uzyskać nieograniczone użycie w produkcji, kup licencję komercyjną.

Krok 3: Skonfiguruj Redactor, aby rozpoznawał własne rozszerzenia

Klasa RedactorConfiguration definiuje wszystkie ustawienia czasu wykonania dla silnika redakcji.

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

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

Wyjaśnienie:

• RedactorConfiguration jest punktem wejścia dla wszystkich opcji redakcji.
• ExtensionFilter przyjmuje listę wzorców z separatorami średnikowymi; dodanie „*.dump” informuje silnik, aby traktował pliki .dump jako obsługiwane.

Krok 4: Zastosuj redakcję do pliku z nowym rozszerzeniem

Klasa Redactor wykonuje rzeczywistą pracę redakcyjną.

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

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

Wyjaśnienie:

• Redactor wykorzystuje przygotowaną konfigurację.
• Metoda Redact odczytuje plik źródłowy, stosuje zdefiniowane reguły redakcji i zapisuje oczyszczony wynik.

Porady dotyczące rozwiązywania problemów

• Nieprawidłowa ścieżka: Upewnij się, że ścieżka pliku źródłowego jest absolutna lub poprawnie względna względem katalogu wykonywalnego.
• Rozszerzenie nie rozpoznane: Sprawdź ponownie, czy dodany wzorzec pasuje dokładnie do przyrostka pliku (bez uwzględniania wielkości liter).
• Błędy licencji: Upewnij się, że plik licencji jest załadowany przed jakimkolwiek wywołaniem redakcji, w przeciwnym razie biblioteka przełącza się w tryb próbny z ograniczonymi funkcjami.

Praktyczne zastosowania

Rozszerzanie rozszerzeń otwiera szereg scenariuszy:

1. Przetwarzanie dokumentów prawnych – Wiele kancelarii przechowuje akta w własnych formatach .case; dodanie „*.case” pozwala na redakcję poufnych danych klienta bez wcześniejszej konwersji.
2. Raportowanie finansowe – Kwartalne raporty często przychodzą jako pliki o własnych nazwach .finrep; jedną zmianą konfiguracji możesz automatycznie usunąć dane osobowe przed archiwizacją.
3. Automatyzacja przepływu pracy – Systemy zarządzania treścią przedsiębiorstwa mogą oznaczać dokumenty własnymi przyrostkami (np. .wfdoc). Rozszerzając rozszerzenia, utrzymujesz krok redakcji w tym samym potoku, zmniejszając opóźnienia i zużycie pamięci.

Względy wydajnościowe

GroupDocs.Redaction jest zaprojektowany dla środowisk o wysokiej przepustowości:

• Optymalizacja zasobów: Zawsze wywołuj redactor.Dispose() lub otaczaj obiekt blokiem using, aby szybko zwolnić uchwyty plików.
• Ślad pamięciowy: Biblioteka strumieniuje dane, więc nawet plik 2 GB zużywa mniej niż 150 MB RAM.
• Przetwarzanie wsadowe: Przetwarzaj kolekcje plików równolegle przy użyciu Parallel.ForEach, ale ogranicz równoległość do liczby rdzeni CPU, aby uniknąć wąskich gardeł I/O.

Kwotowane stwierdzenie: W testach benchmarkowych na standardowej maszynie wirtualnej z 8 rdzeniami, redakcja plików PDF o wielkości 500 MB zajęła mniej niż 4 sekundy na plik, a pliki z własnymi rozszerzeniami działały identycznie.

Najczęściej zadawane pytania

P: Czy mogę rozszerzyć obsługę wielu własnych rozszerzeń jednocześnie?
O: Tak – po prostu oddziel każdy wzorzec średnikiem w settings.ExtensionFilter, np. "*.dump;*.xyz;*.custom".

P: Jak obsłużyć błędy podczas redakcji?
O: Otocz wywołanie Redact blokiem try‑catch, zaloguj wyjątek i opcjonalnie spróbuj ponownie z nową instancją Redactor.

P: Jakie są wymagania systemowe dla GroupDocs.Redaction?
O: .NET Framework 4.6+ lub .NET Core 3.1+; środowisko Windows, Linux lub macOS; oraz co najmniej 2 GB RAM do przetwarzania dużych plików.

P: Czy istnieje limit liczby plików, które mogę redagować jednocześnie?
O: Nie ma sztywnego limitu, ale przetwarzanie w partiach po 50–100 plików zapewnia równowagę między zużyciem pamięci a przepustowością.

P: Jak mogę przyczynić się do społeczności GroupDocs?
O: Dołącz do dyskusji na Forum GroupDocs i udostępnij swoje rozszerzenia lub przykładowy kod.

Zasoby

• Dokumentacja: Zapoznaj się z kompleksowymi przewodnikami na GroupDocs Documentation.
• Referencja API: Szczegółowe sygnatury metod dostępne są pod adresem GroupDocs Redaction API Reference.
• Pobrania: Pobierz najnowsze pliki binarne z GroupDocs Releases.
• Wsparcie: Zadawaj pytania na GroupDocs Forum.

Ostatnia aktualizacja: 2026-07-25
Testowano z: GroupDocs.Redaction 23.12 dla .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}.");
}

Powiązane samouczki

• Implementacja redakcji dokumentów przy użyciu GroupDocs.Redaction .NET: Przewodnik krok po kroku
• Samouczki obsługi formatów dla GroupDocs.Redaction .NET
• Implementacja listy obsługiwanych formatów plików w GroupDocs.Redaction .NET