Gestione delle proprietà del documento
introduzione
Microsoft Excel offre la possibilità di aggiungere proprietà ai file del foglio di calcolo. Queste proprietà del documento forniscono informazioni utili e sono suddivise in 2 categorie come descritto di seguito.
- Proprietà (integrate) definite dal sistema: le proprietà integrate contengono informazioni generali sul documento come titolo del documento, nome dell’autore, statistiche del documento e così via.
- Proprietà (personalizzate) definite dall’utente: proprietà personalizzate definite dall’utente finale sotto forma di coppia nome-valore.
Gestione delle proprietà del documento utilizzando Microsoft Excel
Microsoft Excel consente di gestire le proprietà dei documenti dei file Excel in modalità WYSIWYG. Si prega di seguire i passaggi seguenti per aprire il fileProprietà finestra di dialogo in Excel 2016.
- DalFile menù, selezionareInformazioni.
| Selezionando Menu Informazioni |
|---|
 |
- Clicca suProprietàvoce e selezionare “Proprietà avanzate”.
| Facendo clic su Selezione proprietà avanzate |
|---|
 |
- Gestisci le proprietà del documento del file.
| Finestra di dialogo Proprietà |
|---|
 |
| Nella finestra di dialogo Proprietà, ci sono diverse schede, come Generale, Riepilogo, Statistiche, Contenuti e Personalizzazioni. Ogni scheda consente di configurare diversi tipi di informazioni relative al file. La scheda Personalizzato viene utilizzata per gestire le proprietà personalizzate. |
Lavorare con le proprietà del documento usando Aspose.Cells
Gli sviluppatori possono gestire dinamicamente le proprietà del documento utilizzando le API Aspose.Cells. Questa funzione aiuta gli sviluppatori a memorizzare informazioni utili insieme al file, ad esempio quando il file è stato ricevuto, elaborato, timestamp e così via.
Aspose.Cells for Java scrive direttamente le informazioni su API e il numero di versione nei documenti di output. Ad esempio, dopo aver reso Document to PDF, Aspose.Cells for Java popolaApplicazione campo con valore ‘Aspose.Cells’ ePDF Produttore campo con il valore, ad esempio ‘Aspose.Cells for Java v17.9’.
Si prega di notare che non è possibile incaricare Aspose.Cells for Java di modificare o rimuovere queste informazioni dai documenti di output.
Accesso alle proprietà del documento
Aspose.Cells Le API supportano entrambi i tipi di proprietà del documento, integrate e personalizzate. Aspose.Cells'Cartella di lavoro class rappresenta un file Excel e, come un file Excel, il fileCartella di lavoro la classe può contenere più fogli di lavoro, ciascuno rappresentato daFoglio di lavoro class mentre la raccolta di fogli di lavoro è rappresentata dal fileRaccolta di fogli di lavoroclasse.
Usa ilRaccolta di fogli di lavoroper accedere alle proprietà del documento del file come descritto di seguito.
- Per accedere alle proprietà predefinite del documento, utilizzareWorksheetCollection.BuiltInDocumentProperties.
- Per accedere alle proprietà del documento personalizzate, utilizzare il fileWorksheetCollection.CustomDocumentProperties.
Sia ilWorksheetCollection.BuiltInDocumentProperties eWorksheetCollection.CustomDocumentProperties restituire un’istanza diDocumentoPropertyCollection . Questa raccolta contieneProprietà documentooggetti, ciascuno dei quali rappresenta una singola proprietà del documento incorporata o personalizzata.
Spetta al requisito dell’applicazione come accedere a una proprietà, ovvero; utilizzando l’indice o il nome della proprietà daDocumentoPropertyCollectioncome dimostrato nell’esempio sottostante.
IlProprietà documentoclass consente di recuperare il nome, il valore e il tipo della proprietà del documento:
- Per ottenere il nome della proprietà, utilizzareDocumentProperty.Name.
- Per ottenere il valore della proprietà, utilizzareDocumentProperty.Value. DocumentProperty.Valuerestituisce il valore come oggetto.
- Per ottenere il tipo di proprietà, utilizzareDocumentProperty.Type . Questo restituisce uno deiTipo di proprietàvalori di enumerazione.
Aggiunta o rimozione di proprietà del documento personalizzate
Come descritto in precedenza all’inizio di questo argomento, gli sviluppatori non possono aggiungere o rimuovere proprietà predefinite perché queste proprietà sono definite dal sistema, ma è possibile aggiungere o rimuovere proprietà personalizzate perché sono definite dall’utente.
Aggiunta di proprietà personalizzate
Aspose.Cells API hanno esposto il fileInserisci metodo per ilCustomDocumentPropertyCollection class per aggiungere proprietà personalizzate alla raccolta. IlInserisci aggiunge la proprietà al file Excel e restituisce un riferimento per la nuova proprietà del documento come aProprietà documentooggetto.
Configurazione della proprietà personalizzata “Link al contenuto”.
Per creare una proprietà personalizzata collegata al contenuto di un determinato intervallo, chiama il metodoCustomDocumentPropertyCollection.addLinkToContent metodo e passare il nome della proprietà e l’origine. Puoi verificare se una proprietà è configurata come collegata al contenuto utilizzando il fileDocumentProperty.isLinkedToContent proprietà. Inoltre, è anche possibile ottenere l’intervallo di origine utilizzando il fileFonte proprietà delProprietà documentoclasse.
Usiamo un semplice modello di file Excel Microsoft nell’esempio. La cartella di lavoro ha un intervallo denominato definito etichettatoMyRange che fa riferimento a un valore di cella.
Rimozione delle proprietà personalizzate
Per rimuovere le proprietà personalizzate utilizzando Aspose.Cells, chiama ilDocumentPropertyCollection.remove e passare il nome della proprietà del documento da rimuovere.