"Can I extract metadata from password‑protected PDFs?"

"Yes. Provide the password when constructing `RedactionEngine`; the API will decrypt the header and return metadata."

"Does the API support batch processing of multiple files?"

"Absolutely. Loop through your file collection, instantiate `RedactionEngine` for each, and call `GetDocumentInfo()`—the engine is lightweight enough for thousands of files."

"What happens if a document has no metadata?"

"The corresponding properties return `null` or default values; you can safely check for `null` before using them."

"Is it possible to modify metadata after extraction?"

"GroupDocs.Redaction focuses on redaction, not editing metadata. Use GroupDocs.Metadata or another library for write‑back scenarios."

"Which .NET versions are officially supported?"

".NET Framework 4.7.2+, .NET Core 3.1+, .NET 5+, and .NET 6+ are fully supported."

Samouczki dotyczące informacji o dokumencie dla GroupDocs.Redaction .NET

W tym hubie odkryjesz, jak wyodrębnić metadane dokumentu z szerokiego zakresu typów plików, określić liczbę stron i wygenerować obrazy podglądu przed uruchomieniem operacji redakcji. Programowo uzyskując te informacje, możesz zdecydować, które pliki wymagają specjalnego traktowania, egzekwować zasady zgodności i poprawić ogólną wydajność przetwarzania. Wszystkie przykłady są napisane w C# i skierowane do .NET 6+, więc możesz je od razu wstawić do istniejących projektów.

Szybkie odpowiedzi

Jak wyodrębnić metadane? Użyj RedactionEngine.GetDocumentInfo(), aby pobrać właściwości takie jak autor, data utworzenia i liczba stron.
Czy mogę odczytać metadane ze strumienia? Tak — przekaż MemoryStream zawierający plik do tej samej metody API.
Jakie formaty są obsługiwane? Ponad 100 formatów, w tym PDF, DOCX, PPTX i pliki graficzne.
Czy pobieranie liczby stron jest szybkie? Silnik odczytuje tylko nagłówek pliku, dostarczając liczbę stron w mniej niż 50 ms dla większości dokumentów.
Czy potrzebna jest licencja do rozwoju? Tymczasowa licencja działa w testach; pełna licencja jest wymagana w środowisku produkcyjnym.

Co oznacza „wyodrębnić metadane dokumentu”?

Wyodrębnić metadane dokumentu oznacza programowe pobieranie osadzonych właściwości — takich jak autor, tytuł, data utworzenia i liczba stron — z pliku bez otwierania go w przeglądarce. Ta lekka operacja pozwala aplikacji podejmować świadome decyzje przed rozpoczęciem redakcji.

Dlaczego wyodrębniać metadane dokumentu za pomocą GroupDocs.Redaction?

GroupDocs.Redaction może odczytywać metadane z ponad 100 formatów plików, jednocześnie utrzymując zużycie pamięci poniżej 10 MB dla dokumentów do 500 stron. API zwraca w pełni typowany obiekt DocumentInfo, eliminując potrzebę własnych parserów i skracając czas rozwoju nawet o 70 %.

Wymagania wstępne

.NET 6+ (lub .NET Core 3.1 / .NET Framework 4.7.2)
Zainstalowany pakiet NuGet GroupDocs.Redaction for .NET
Tymczasowy lub pełny klucz licencyjny (dostępny w portalu GroupDocs)

Jak wyodrębnić metadane dokumentu przy użyciu GroupDocs.Redaction .NET?

RedactionEngine jest podstawowym komponentem, który ładuje dokumenty i udostępnia metody wyodrębniania metadanych. GetDocumentInfo() zwraca obiekt DocumentInfo zawierający metadane takie jak autor, tytuł i liczba stron. Załaduj plik (lub strumień) przy pomocy RedactionEngine, wywołaj GetDocumentInfo() i odczytaj zwrócone właściwości. Operacja kończy się w jednej linii kodu i nie wymaga ładowania całego dokumentu do pamięci.

Jak uzyskać liczbę stron z dokumentu?

DocumentInfo jest typowanym obiektem, który przechowuje wyodrębnione metadane dokumentu. Właściwość DocumentInfo.PageCount zwraca łączną liczbę stron. Wartość ta jest obliczana na podstawie nagłówka pliku, co pozwala silnikowi określić liczbę stron bez pełnego ładowania dokumentu, więc nawet 300‑stronicowy PDF jest przetwarzany w zaledwie kilka milisekund.

Jak odczytać metadane ze strumienia?

RedactionEngine ładuje dokument z ścieżki pliku lub ze strumienia i udostępnia możliwości wyodrębniania metadanych. Przekaż instancję Stream (np. MemoryStream) do RedactionEngine zamiast ścieżki pliku. Silnik odczytuje nagłówek strumienia, wyodrębnia metadane i automatycznie zwalnia strumień, zapewniając minimalne zużycie pamięci i szybkie przetwarzanie nawet dużych plików.

Jak wyodrębnić metadane w C#?

Użyj następującego wzorca:

Utwórz instancję RedactionEngine z ścieżką pliku lub strumieniem.
Wywołaj GetDocumentInfo().
Uzyskaj dostęp do właściwości takich jak Author, Title, CreatedDate i PageCount.

Te kroki dostarczają pełny zrzut metadanych gotowy do dalszej logiki biznesowej.

Typowe problemy i rozwiązania

Metadane są puste – Upewnij się, że plik źródłowy faktycznie zawiera osadzone właściwości; niektóre skany usuwają metadane.
Błąd nieobsługiwanego formatu – Sprawdź, czy rozszerzenie pliku znajduje się w tabeli obsługiwanych formatów GroupDocs.Redaction (ponad 100 pozycji).
Spowolnienie wydajności przy dużych plikach – Użyj flagi LoadOptions ReadOnly = true, aby uniknąć niepotrzebnego przydzielania zasobów.

Najczęściej zadawane pytania

Q: Czy mogę wyodrębnić metadane z PDF‑ów zabezpieczonych hasłem?
A: Tak. Podaj hasło podczas tworzenia RedactionEngine; API odszyfruje nagłówek i zwróci metadane.

Q: Czy API obsługuje przetwarzanie wsadowe wielu plików?
A: Absolutnie. Przejdź pętlą przez swoją kolekcję plików, utwórz RedactionEngine dla każdego i wywołaj GetDocumentInfo() — silnik jest na tyle lekki, że radzi sobie z tysiącami plików.

Q: Co się stanie, jeśli dokument nie ma metadanych?
A: Odpowiednie właściwości zwracają null lub wartości domyślne; możesz bezpiecznie sprawdzić null przed ich użyciem.

Q: Czy można modyfikować metadane po ich wyodrębnieniu?
A: GroupDocs.Redaction koncentruje się na redakcji, a nie na edycji metadanych. Do scenariuszy zapisu użyj GroupDocs.Metadata lub innej biblioteki.

Q: Które wersje .NET są oficjalnie wspierane?
A: .NET Framework 4.7.2+, .NET Core 3.1+, .NET 5+ i .NET 6+ są w pełni obsługiwane.

Zakończenie

Opanowując techniki wyodrębnić metadane dokumentu, umożliwiasz aplikacjom podejmowanie lepszych decyzji redakcyjnych, egzekwowanie polityk zgodności i zwiększenie ogólnej prędkości przetwarzania. Zapoznaj się z poniższymi samouczkami, aby zobaczyć konkretne implementacje podglądów jednostronicowych, wyodrębniania ze strumieni i pełnego pobierania metadanych.

Dodatkowe zasoby

Ostatnia aktualizacja: 2026-06-06
Testowano z: GroupDocs.Redaction 4.0 for .NET
Autor: GroupDocs