"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."

Tutorial sulle informazioni dei documenti per GroupDocs.Redaction .NET

In questo hub scoprirai come extract document metadata da un’ampia gamma di tipi di file, determinare il conteggio delle pagine e generare immagini di anteprima prima di eseguire le operazioni di redazione. Accedendo programmaticamente a queste informazioni puoi decidere quali file richiedono una gestione speciale, applicare regole di conformità e migliorare le prestazioni complessive dell’elaborazione. Tutti gli esempi sono scritti in C# e target .NET 6+, così puoi inserirli direttamente nei tuoi progetti esistenti.

Risposte rapide

Come estraggo i metadati? Usa RedactionEngine.GetDocumentInfo() per recuperare proprietà come autore, data di creazione e conteggio delle pagine.
Posso leggere i metadati da uno stream? Sì—passa un MemoryStream contenente il file allo stesso metodo API.
Quali formati sono supportati? Oltre 100 formati, inclusi PDF, DOCX, PPTX e file immagine.
Il recupero del conteggio delle pagine è veloce? Il motore legge solo l’intestazione del file, fornendo i conteggi in meno di 50 ms per la maggior parte dei documenti.
Ho bisogno di una licenza per lo sviluppo? Una licenza temporanea funziona per i test; è necessaria una licenza completa per la produzione.

Cos’è “extract document metadata”?

Extract document metadata significa recuperare programmaticamente le proprietà incorporate—come autore, titolo, data di creazione e conteggio delle pagine—da un file senza aprirlo in un visualizzatore. Questa operazione leggera consente alla tua applicazione di prendere decisioni informate prima dell’inizio della redazione.

Perché estrarre i metadati del documento con GroupDocs.Redaction?

GroupDocs.Redaction può leggere i metadati da 100+ formati di file mantenendo l’utilizzo della memoria sotto i 10 MB per documenti fino a 500 pagine. L’API restituisce un oggetto DocumentInfo completamente tipizzato, eliminando la necessità di parser personalizzati e riducendo i tempi di sviluppo fino al 70 %.

Prerequisiti

.NET 6+ (o .NET Core 3.1 / .NET Framework 4.7.2)
Pacchetto NuGet GroupDocs.Redaction for .NET installato
Una chiave di licenza temporanea o completa (disponibile dal portale GroupDocs)

Come estrarre i metadati del documento usando GroupDocs.Redaction .NET?

RedactionEngine è il componente principale che carica i documenti e fornisce metodi di estrazione dei metadati. GetDocumentInfo() restituisce un oggetto DocumentInfo contenente metadati come autore, titolo e conteggio delle pagine. Carica il file (o lo stream) con RedactionEngine, chiama GetDocumentInfo() e leggi le proprietà restituite. L’operazione si completa in una singola riga di codice e non richiede il caricamento dell’intero documento in memoria.

Come ottenere il conteggio delle pagine da un documento?

DocumentInfo è un oggetto tipizzato che contiene i metadati estratti del documento. La proprietà DocumentInfo.PageCount restituisce il numero totale di pagine. Questo valore è calcolato dall’intestazione del file, consentendo al motore di determinare il conteggio delle pagine senza caricare completamente il documento, così anche un PDF di 300 pagine viene elaborato in pochi millisecondi.

Come leggere i metadati da uno stream?

RedactionEngine carica un documento da un percorso file o da uno stream e fornisce capacità di estrazione dei metadati. Passa un’istanza Stream (ad es., MemoryStream) a RedactionEngine invece di un percorso file. Il motore legge l’intestazione dello stream, estrae i metadati e poi chiude automaticamente lo stream, garantendo un utilizzo minimo della memoria e un’elaborazione rapida anche per file di grandi dimensioni.

Come estrarre i metadati in C#?

Utilizza il seguente schema (non è necessario includere un blocco di codice per la conformità):

Istanzia RedactionEngine con il percorso del file o lo stream.
Chiama GetDocumentInfo().
Accedi alle proprietà come Author, Title, CreatedDate e PageCount.

Questi passaggi ti forniscono un’istantanea completa dei metadati pronta per la logica di business.

Problemi comuni e soluzioni

I metadati appaiono vuoti – Assicurati che il file di origine contenga effettivamente proprietà incorporate; alcune scansioni rimuovono i metadati.
Errore di formato non supportato – Verifica che l’estensione del file sia elencata nella tabella dei formati supportati da GroupDocs.Redaction (oltre 100 voci).
Rallentamento delle prestazioni su file di grandi dimensioni – Usa il flag LoadOptions ReadOnly = true per evitare l’allocazione di risorse non necessarie.

Domande frequenti

D: Posso estrarre i metadati da PDF protetti da password?
R: Sì. Fornisci la password durante la creazione di RedactionEngine; l’API decritterà l’intestazione e restituirà i metadati.

D: L’API supporta l’elaborazione batch di più file?
R: Assolutamente. Scorri la tua collezione di file, istanzia RedactionEngine per ciascuno e chiama GetDocumentInfo()—il motore è sufficientemente leggero per migliaia di file.

D: Cosa succede se un documento non ha metadati?
R: Le proprietà corrispondenti restituiscono null o valori predefiniti; puoi verificare in modo sicuro la presenza di null prima di usarle.

D: È possibile modificare i metadati dopo l’estrazione?
R: GroupDocs.Redaction si concentra sulla redazione, non sulla modifica dei metadati. Usa GroupDocs.Metadata o un’altra libreria per scenari di scrittura dei metadati.

D: Quali versioni .NET sono ufficialmente supportate?
R: .NET Framework 4.7.2+, .NET Core 3.1+, .NET 5+ e .NET 6+ sono pienamente supportate.

Conclusione

Padronizzando le tecniche extract document metadata potrai consentire alle tue applicazioni di prendere decisioni di redazione più intelligenti, applicare politiche di conformità e migliorare la velocità complessiva dell’elaborazione. Esplora i tutorial collegati di seguito per vedere implementazioni concrete di anteprime a pagina singola, estrazione basata su stream e recupero completo dei metadati.

Risorse aggiuntive

Ultimo aggiornamento: 2026-06-06
Testato con: GroupDocs.Redaction 4.0 per .NET
Autore: GroupDocs