Gestione delle proprietà del documento
Introduzione
Microsoft Excel fornisce la possibilità di aggiungere proprietà ai file di fogli elettronici. Queste proprietà del documento forniscono informazioni utili e sono divise in 2 categorie come dettagliato di seguito.
- Proprietà predefinite di sistema (builtin): Le proprietà incorporano informazioni generali sul documento come il titolo del documento, il nome dell’autore, le statistiche del documento e così via.
- Proprietà definite dall’utente (personalizzate): Proprietà personalizzate definite dall’utente sotto forma di coppia nome-valore.
Gestione delle proprietà del documento utilizzando Microsoft Excel
Microsoft Excel consente di gestire le proprietà del documento dei file Excel in modo WYSIWYG. Seguire i passaggi seguenti per aprire il dialogo Proprietà in Excel 2016.
- Dal menu File, seleziona Informazioni.
| Selezionare il menu Informazioni |
|---|
 |
- Clicca sulla voce Proprietà e seleziona “Proprietà avanzate”.
| Selezione Proprietà Avanzate |
|---|
 |
- Gestire le proprietà del documento del file.
| Dialogo Proprietà |
|---|
 |
| Nel dialogo Proprietà, ci sono diverse schede, come Generale, Riepilogo, Statistiche, Contenuti e Personalizzati. Ogni scheda aiuta a configurare diversi tipi di informazioni relative al file. La scheda Personalizzati è utilizzata per gestire le proprietà personalizzate. |
Lavorare con le proprietà del documento utilizzando Aspose.Cells
Gli sviluppatori possono gestire dinamicamente le proprietà del documento utilizzando le API di Aspose.Cells. Questa funzionalità aiuta gli sviluppatori a memorizzare informazioni utili insieme al file, come quando il file è stato ricevuto, elaborato, con timestamp e così via.
Aspose.Cells for Java scrive direttamente le informazioni su API e Numero di versione nei documenti di output. Ad esempio, durante la resa del documento in PDF, Aspose.Cells for Java popola il campo Applicazione con il valore ‘Aspose.Cells’ e il campo Produttore PDF con il valore, ad esempio ‘Aspose.Cells for Java v17.9’.
Si noti che non è possibile istruire Aspose.Cells for Java a modificare o rimuovere queste informazioni dai documenti di output.
Accesso alle proprietà del documento
Le API di Aspose.Cells supportano entrambi i tipi di proprietà del documento, integrate e personalizzate. La classe Workbook di Aspose.Cells rappresenta un file Excel e, come un file Excel, la classe Workbook può contenere più fogli di lavoro, ognuno rappresentato dalla classe Worksheet mentre la collezione di fogli di lavoro è rappresentata dalla classe WorksheetCollection
Utilizzare WorksheetCollection per accedere alle proprietà del documento del file come descritto di seguito.
- Per accedere alle proprietà integrate del documento, utilizzare WorksheetCollection.BuiltInDocumentProperties.
- Per accedere alle proprietà del documento personalizzate, utilizzare il WorksheetCollection.CustomDocumentProperties.
Sia il WorksheetCollection.BuiltInDocumentProperties che il WorksheetCollection.CustomDocumentProperties restituiscono un’istanza di DocumentPropertyCollection. Questa raccolta contiene DocumentProperty oggetti, ciascuno dei quali rappresenta una singola proprietà del documento incorporata o personalizzata.
È a discrezione delle esigenze dell’applicazione come accedere a una proprietà, cioè; utilizzando l’indice o il nome della proprietà da DocumentPropertyCollection come dimostrato nell’esempio sotto.
La classe DocumentProperty consente di recuperare il nome, il valore e il tipo della proprietà del documento:
- Per ottenere il nome della proprietà, utilizzare DocumentProperty.Name.
- Per ottenere il valore della proprietà, utilizzare DocumentProperty.Value. DocumentProperty.Value restituisce il valore come un Oggetto.
- Per ottenere il tipo di proprietà, utilizzare DocumentProperty.Type. Questo restituisce uno dei valori di enumerazione di PropertyType.
Aggiunta o rimozione delle proprietà personalizzate del documento
Come abbiamo descritto in precedenza all’inizio di questo argomento, i programmatori non possono aggiungere o rimuovere proprietà integrate perché queste proprietà sono definite dal sistema, ma è possibile aggiungere o rimuovere proprietà personalizzate poiché queste sono definite dall’utente.
Aggiunta di proprietà personalizzate
Le API di Aspose.Cells hanno esposto il add metodo per la classe CustomDocumentPropertyCollection al fine di aggiungere proprietà personalizzate alla raccolta. Il metodo add aggiunge la proprietà al file Excel e restituisce un riferimento per la nuova proprietà del documento come un oggetto DocumentProperty.
Configurazione della proprietà personalizzata “Collegamento al contenuto”
Per creare una proprietà personalizzata collegata al contenuto di un determinato intervallo, chiamare il metodo CustomDocumentPropertyCollection.addLinkToContent e passare il nome della proprietà e la sorgente. È possibile verificare se una proprietà è configurata come collegata al contenuto utilizzando la proprietà DocumentProperty.isLinkedToContent. Inoltre, è anche possibile ottenere l’intervallo di origine utilizzando la proprietà Source della classe DocumentProperty.
Utilizziamo un file modello semplice di Microsoft Excel nell’esempio. Il workbook ha un intervallo denominato definito MyRange, che si riferisce a un valore della cella.
Rimozione delle proprietà personalizzate
Per rimuovere le proprietà personalizzate utilizzando Aspose.Cells, chiamare il metodo DocumentPropertyCollection.remove e passare il nome della proprietà del documento da rimuovere.