Leggi i metadati di excel con GroupDocs.Editor per .NET

In questo tutorial completo imparerai a read excel metadata da una cartella di lavoro Excel, estrarre proprietà personalizzate e, opzionalmente, proteggere un file DOCX — tutto usando la stessa API GroupDocs.Editor per .NET. Che tu stia costruendo un indice di ricerca, una pipeline di audit o un sistema di consegna sicura dei documenti, i passaggi seguenti ti offrono un modello pronto per la produzione che funziona su .NET Framework 4.5+, .NET Core 3.1+ e .NET 5/6/7.

Risposte rapide

  • Che cos’è read excel metadata? È il recupero programmatico delle proprietà integrate e personalizzate della cartella di lavoro (autore, titolo, azienda, ecc.) senza aprire il file in un editor UI completo.
  • Perché scegliere GroupDocs.Editor per questo compito? La libreria supporta 120+ input and output formats, trasmette i file per mantenere basso l’uso di memoria e fornisce una singola API sia per l’estrazione dei metadati sia per la protezione dei documenti.
  • Posso proteggere un DOCX dopo aver estratto i suoi metadati? Sì — estrai prima i metadati, poi applica ProtectionOptions alla stessa istanza Editor.
  • Ho bisogno di una licenza per l’uso in produzione? È necessaria una licenza valida di GroupDocs.Editor per le distribuzioni commerciali; è disponibile una licenza di prova gratuita per la valutazione.
  • Quali versioni .NET sono compatibili? .NET Framework 4.5+, .NET Core 3.1+, .NET 5, .NET 6 e .NET 7 sono pienamente supportate.

Che cos’è read excel metadata?

Read excel metadata è il processo di recupero programmatico delle proprietà integrate e personalizzate della cartella di lavoro — come autore, titolo, azienda, data di creazione e campi definiti dall’utente — direttamente dall’archivio interno dei metadati del file. Queste informazioni sono memorizzate nelle tabelle delle proprietà della cartella di lavoro e possono essere accessibili senza renderizzare alcun foglio di lavoro.

Perché usare GroupDocs.Editor per l’estrazione dei metadati?

GroupDocs.Editor trasmette il file sorgente, quindi non carica mai l’intera cartella di lavoro in memoria. Questo consente l’elaborazione di cartelle di lavoro da 500 pagine in meno di 2 secondi su un server tipico mantenendo l’uso della RAM al di sotto dei 30 MB. La libreria normalizza anche i nomi delle proprietà tra i formati, permettendoti di utilizzare una singola chiamata per recuperare i metadati di Excel, Word, PDF e altri documenti.

Prerequisiti

  • Visual Studio 2022 (o qualsiasi IDE compatibile con .NET)
  • Pacchetto NuGet GroupDocs.Editor per .NET installato
  • Una licenza valida di GroupDocs.Editor (o licenza di prova temporanea)

Come leggere i metadati di excel con GroupDocs.Editor

Carica la cartella di lavoro con la classe Editor, chiama l’API dei metadati e poi lavora con il dizionario restituito.
Editor è la classe principale che carica e manipola i documenti in GroupDocs.Editor.

Risposta diretta:
Istanzia Editor con il percorso del tuo file Excel, invoca GetMetadata() per ricevere un Dictionary<string, string> contenente sia le proprietà standard che quelle personalizzate, e poi itera sulla collezione per registrare o memorizzare ogni coppia chiave/valore. GetMetadata() restituisce un dizionario di tutte le proprietà del documento, sia standard che personalizzate. L’intera operazione si completa in due chiamate di metodo e non richiede configurazioni aggiuntive.

Guida passo‑passo

  1. Crea l’istanza Editor – passa il percorso completo del file o uno Stream al costruttore.
  2. Chiama il metodo di estrazione dei metadati – editor.GetMetadata() restituisce tutte le proprietà disponibili.
  3. Elabora i risultati – puoi scriverli in un file di log, inserirli in un database o usarli per guidare le regole di business successive.

Consiglio professionale: Esegui l’estrazione dei metadati prima di qualsiasi passaggio di protezione o conversione; questo garantisce che le proprietà personalizzate non vengano rimosse da elaborazioni successive.

Come proteggere i file docx (how to protect docx)

Applicare la protezione con password o restrizioni di sola lettura a un documento Word dopo aver estratto i suoi metadati è semplice con GroupDocs.Editor.

Risposta diretta:
Carica il DOCX usando Editor, configura un oggetto ProtectionOptions con la password desiderata e il tipo di restrizione, quindi chiama editor.Protect(protectionOptions) seguito da editor.Save(outputPath). ProtectionOptions specifica la password e le restrizioni di modifica per il documento protetto. La protezione viene applicata in un unico passaggio, preservando tutti i metadati precedentemente estratti.

Flusso di lavoro per la protezione

  • Carica il DOCX – riutilizza la stessa istanza Editor se stai elaborando più file.
  • Configura ProtectionOptions – imposta Password, ReadOnly o restrizioni di modifica specifiche come AllowComments.
  • Salva il file protetto – l’output mantiene il contenuto e i metadati originali mentre applica le impostazioni di sicurezza da te definite.

Casi d’uso comuni

  • Indicizzazione della ricerca aziendale: Arricchisci gli indici di ricerca con autore, titolo e tag personalizzati estratti dai report Excel caricati.
  • Audit di conformità: Verifica le date di creazione e i campi autore prima di archiviare i documenti per soddisfare gli standard normativi.
  • Pipeline di elaborazione batch: Scorri una directory di cartelle di lavoro, estrai i metadati e persisti i risultati in un repository centrale di metadati.
  • Consegna sicura dei documenti: Estrarre prima i metadati, poi bloccare il DOCX con una password prima di trasmetterlo a partner esterni.

Suggerimenti e migliori pratiche

  • Cache i metadati frequentemente accessi per ridurre al minimo I/O in scenari ad alto throughput.
  • Convalida i nomi delle proprietà personalizzate rispetto a una whitelist per evitare collisioni con chiavi riservate.
  • Combina l’estrazione con la conversione quando migri file legacy; GroupDocs.Editor può convertire Excel in PDF preservando i metadati.
  • Testa con file protetti da password usando l’oggetto LoadOptions per garantire che la tua logica di estrazione gestisca correttamente i workbook crittografati.

Risorse aggiuntive

Domande frequenti

D: Come estraggo i metadati da un PDF protetto da password?
R: Fornisci la password tramite un oggetto LoadOptions quando crei l’istanza Editor, poi chiama GetMetadata() come al solito.

D: Posso modificare un documento dopo aver estratto i suoi metadati?
R: Sì — l’estrazione dei metadati non blocca il file. Puoi eseguire qualsiasi operazione di modifica, come inserire testo o convertire formati, dopo aver letto le proprietà.

D: Qual è il modo migliore per proteggere un DOCX dopo la modifica?
R: Usa il flusso di lavoro “how to protect docx”: configura ProtectionOptions con una password robusta e il livello di restrizione richiesto, poi salva il documento.

D: È supportata l’elaborazione batch di più file per l’estrazione dei metadati?
R: Assolutamente. Avvolgi la logica di estrazione in un ciclo foreach o usa Parallel.ForEach per l’elaborazione concorrente; l’architettura di streaming della libreria garantisce un basso consumo di memoria.

D: GroupDocs.Editor supporta campi di metadati personalizzati?
R: Sì — sia le proprietà standard che quelle personalizzate della cartella di lavoro sono restituite nel dizionario dei metadati, permettendoti di leggerle e scriverle con la stessa API.

D: Posso leggere i metadati di excel senza caricare l’intera cartella di lavoro in memoria?
R: GroupDocs.Editor trasmette il file ed estrae i metadati direttamente dalle tabelle delle proprietà, mantenendo l’uso della memoria minimo anche per cartelle di lavoro di grandi dimensioni.

D: In che modo read excel metadata differisce dall’uso di Office Interop?
R: A differenza di Interop, GroupDocs.Editor è lato server, non richiede l’installazione di Microsoft Office, funziona su container Linux e elabora file fino a 2 GB senza degradazione delle prestazioni.

Ultimo aggiornamento: 2026-08-05
Testato con: GroupDocs.Editor 23.12 for .NET
Autore: GroupDocs

Tutorial correlati