Gestisci le 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 divise in 2 categorie come descritto di seguito.

• Proprietà definite dal sistema (incorporate): 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.

Il punto più importante da sapere sulle proprietà integrate e personalizzate è che è possibile accedere e modificare le proprietà integrate, ma non crearle o rimuoverle. Tuttavia, è possibile creare e gestire proprietà personalizzate.

Come gestire le proprietà del documento utilizzando Microsoft Excel

Microsoft Excel permette di gestire le proprietà del documento dei file Excel in modalità WYSIWYG. Si prega di seguire i passaggi seguenti per aprire il fileProprietà finestra di dialogo in Excel 2016.

1. DalFile selezionare Informazioni*.

Selezione del menu Informazioni

1. Clicca suProprietà titolo e selezionare “Proprietà avanzate”.

Facendo clic su Selezione proprietà avanzate

1. Gestisci le proprietà del documento del file.

Finestra di dialogo Proprietà
Nella finestra di dialogo Proprietà sono presenti diverse schede, come Generale, Riepilogo, Statistiche, Contenuti e Personalizzate. Ciascuna scheda aiuta a configurare diversi tipi di informazioni relative al file. La scheda Personalizzata viene 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 Aspose.Cells. Questa funzionalità 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 .NET scrive direttamente le informazioni su API e il numero di versione nei documenti di output. Ad esempio, dopo aver eseguito il rendering del documento su PDF, Aspose.Cells for .NET viene popolatoApplicazione campo con valore ‘Aspose.Cells’ ePDF Produttore campo con il valore, ad esempio ‘Aspose.Cells v17.9’.

Tieni presente che non puoi chiedere a Aspose.Cells for .NET di modificare o rimuovere queste informazioni dai documenti di output.

Come accedere 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 classe mentre la raccolta di fogli di lavoro è rappresentata daRaccolta 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à del documento integrate, utilizzareWorksheetCollection.BuiltInDocumentProperties.
• Per accedere alle proprietà personalizzate del documento, utilizzareWorksheetCollection.CustomDocumentProperties.

Entrambi iWorksheetCollection.BuiltInDocumentProperties EWorksheetCollection.CustomDocumentProperties restituire l’istanza diAspose.Cells.Properties.DocumentPropertyCollection. Questa raccolta contieneAspose.Cells.Properties.DocumentPropertyoggetti, ognuno dei quali rappresenta una singola proprietà del documento incorporata o personalizzata.

Spetta ai requisiti della domanda come accedere a una proprietà, cioè; utilizzando l’indice o il nome della proprietà dal fileDocumentPropertyCollectioncome dimostrato nell’esempio seguente.

ILAspose.Cells.Properties.DocumentPropertyLa classe consente di recuperare il nome, il valore e il tipo della proprietà del documento:

• Per ottenere il nome della proprietà, utilizzareDocumentProperty.Nome.
• Per ottenere il valore della proprietà, utilizzareDocumentProperty.Value. DocumentProperty.Valuerestituisce il valore come oggetto.
• Per ottenere il tipo di proprietà, utilizzareDocumentProperty.Type . Ciò restituisce uno deiTipo di proprietàvalori di enumerazione. Dopo aver ottenuto il tipo di proprietà, utilizza uno dei fileDocumentProperty.ToXXX metodi per ottenere il valore del tipo appropriato invece di utilizzareDocumentProperty.Value . ILDocumentProperty.ToXXXi metodi sono descritti nella tabella seguente.

ILProprietàdocumentoLa classe fornisce anche un insieme di metodi che restituiscono i valori di altri tipi di dati.

Nome del membro	Descrizione	Metodo ToXXX
Booleano	Il tipo di dati della proprietà è booleano	ToBool
Data	Il tipo di dati della proprietà è DateTime. Tieni presente che Microsoft Excel memorizza solo la parte della data, non è possibile archiviare l’ora in una proprietà personalizzata di questo tipo	ToDateTime
Galleggiante	Il tipo di dati della proprietà è Double	Raddoppiare
Numero	Il tipo di dati della proprietà è Int32	ToInt
String	Il tipo di dati della proprietà è String	Accordare

Come aggiungere o rimuovere proprietà personalizzate del documento

Come descritto in precedenza all’inizio di questo argomento, gli sviluppatori non possono aggiungere o rimuovere proprietà integrate perché queste proprietà sono definite dal sistema ma è possibile aggiungere o rimuovere proprietà personalizzate perché sono definite dall’utente.

Come aggiungere proprietà personalizzate

Aspose.Cells Le API hanno esposto il fileAggiungere metodo per ilCustomDocumentPropertyCollection classe per aggiungere proprietà personalizzate alla raccolta. ILAggiungere Il metodo aggiunge la proprietà al file Excel e restituisce un riferimento per la nuova proprietà del documento come fileAspose.Cells.Properties.DocumentPropertyoggetto.

Come configurare la proprietà personalizzata “Link al contenuto”.

Per creare una proprietà personalizzata collegata al contenuto di un determinato intervallo, chiama il fileCustomDocumentPropertyCollection.AddLinkToContent metodo e passare il nome e l’origine della proprietà. 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.

Nell’esempio utilizziamo un semplice file Excel modello Microsoft. La cartella di lavoro ha un intervallo denominato definito etichettatoMyRange che si riferisce al valore di una cella.

Come rimuovere le proprietà personalizzate

Per rimuovere le proprietà personalizzate utilizzando Aspose.Cells, chiama ilDocumentPropertyCollection.Removemetodo e passare il nome della proprietà del documento da rimuovere.

Argomenti avanzati

• Aggiunta di proprietà personalizzate visibili nel pannello informazioni del documento
• Impostazione delle proprietà ScaleCrop e LinksUpToDate delle proprietà del documento integrate
• Specificare la versione del documento del file Excel utilizzando le proprietà del documento integrate
• Specificare la lingua del file Excel utilizzando le proprietà del documento integrate