Gestire le 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.

Il punto più importante da conoscere sulle proprietà integrate e personalizzate è che le proprietà integrate possono essere accessibili e modificate, ma non create o rimosse. Tuttavia, le proprietà personalizzate possono essere create e gestite.

Come gestire le proprietà del documento con Microsoft Excel

Microsoft Excel ti permette di gestire le proprietà dei file Excel in modo WYSIWYG. Segui i seguenti passaggi 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.

Come 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 .NET scrive direttamente le informazioni su API e Numero di Versione nei documenti di output. Ad esempio, al momento del rendering del Documento in PDF, Aspose.Cells for .NET popola il campo Applicazione con il valore ‘Aspose.Cells’ e il campo Produttore PDF con il valore, ad es. ‘Aspose.Cells v17.9’.

Si noti che non è possibile istruire Aspose.Cells for .NET a modificare o rimuovere queste informazioni dai Documenti di output.

Come accedere 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à personalizzate del documento, utilizzare WorksheetCollection.CustomDocumentProperties.

Sia il WorksheetCollection.BuiltInDocumentProperties che il WorksheetCollection.CustomDocumentProperties restituiscono l’istanza di Aspose.Cells.Properties.DocumentPropertyCollection. Questa raccolta contiene Aspose.Cells.Properties.DocumentProperty oggetti, ognuno dei quali rappresenta una singola proprietà del documento integrata 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 Aspose.Cells.Properties.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 PropertyType. Dopo aver ottenuto il tipo di proprietà, utilizzare uno dei metodi DocumentProperty.ToXXX per ottenere il valore del tipo appropriato anziché utilizzare DocumentProperty.Value. I metodi DocumentProperty.ToXXX sono descritti nella tabella sotto.

La classe DocumentProperty fornisce anche un insieme di metodi che restituiscono i valori di altri tipi di dati.

Nome membro	Descrizione	Metodo ToXXX
Boolean	Il tipo di dati della proprietà è Booleano	ToBool
Date	Il tipo di dati della proprietà è DataOra. Nota che Microsoft Excel memorizza solo la parte della data, nessuna ora può essere memorizzata in una proprietà personalizzata di questo tipo	ToDateTime
Float	Il tipo di dati della proprietà è Double	ToDouble
Number	Il tipo di dati della proprietà è Int32	ToInt
String	Il tipo di dati della proprietà è Stringa	ToString

Come Aggiungere o Rimuovere Proprietà del Documento Personalizzate

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.

Come Aggiungere Proprietà Personalizzate

Le API di Aspose.Cells hanno esposto il metodo Add per la classe CustomDocumentPropertyCollection al fine di aggiungere proprietà personalizzate alla raccolta. Il metodo Add aggiunge la proprietà al file di Excel e restituisce un riferimento per la nuova proprietà del documento come un oggetto Aspose.Cells.Properties.DocumentProperty.

Come Configurare 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.

Come rimuovere 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.

Argomenti avanzati

Stampa e anteprima del libro Gestire i fogli di lavoro dei file di Microsoft Excel.