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 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 permette di gestire le proprietà dei documenti dei file Excel in maniera WYSIWYG. Si prega di seguire i passaggi seguenti per aprire il fileProprietà finestra di dialogo in Excel 2016.

  1. DalFile menù, selezionareInformazioni.
Selezionando Menu Informazioni
cose da fare:immagine_alt_testo
  1. Clicca suProprietàvoce e selezionare “Proprietà avanzate”.
Facendo clic su Selezione proprietà avanzate
cose da fare:immagine_alt_testo
  1. Gestisci le proprietà del documento del file.
Finestra di dialogo Proprietà
cose da fare:immagine_alt_testo
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.

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.

Sia ilWorksheetCollection.BuiltInDocumentProperties eWorksheetCollection.CustomDocumentProperties restituire l’istanza diAspose.Cells.Properties.DocumentPropertyCollection. Questa raccolta contieneAspose.Cells.Properties.DocumentPropertyoggetti, 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.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample-document-properties.xlsx");
// Retrieve a list of all custom document properties of the Excel file
Aspose.Cells.Properties.DocumentPropertyCollection customProperties = workbook.Worksheets.CustomDocumentProperties;
// Accessing a custom document property by using the property name
Aspose.Cells.Properties.DocumentProperty customProperty1 = customProperties["ContentTypeId"];
Console.WriteLine(customProperty1.Name + " " + customProperty1.Value);
// Accessing the same custom document property by using the property index
Aspose.Cells.Properties.DocumentProperty customProperty2 = customProperties[0];
Console.WriteLine(customProperty2.Name + " " + customProperty2.Value);

IlAspose.Cells.Properties.DocumentPropertyclass consente di recuperare il nome, il valore e il tipo della proprietà del documento:

Nome del membro Descrizione Metodo ToXXX
Booleano Il tipo di dati della proprietà è booleano ToBool
Data Il tipo di dati della proprietà è DateTime. Si noti che Microsoft Excel memorizza solo
la parte relativa alla data, nessuna ora può essere memorizzata 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
Corda Il tipo di dati della proprietà è String Accordare
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample-document-properties.xlsx");
// Retrieve a list of all custom document properties of the Excel file
Aspose.Cells.Properties.DocumentPropertyCollection customProperties = workbook.Worksheets.CustomDocumentProperties;
// Accessing a custom document property
Aspose.Cells.Properties.DocumentProperty customProperty1 = customProperties[0];
// Storing the value of the document property as an object
object objectValue = customProperty1.Value;
// Accessing a custom document property
Aspose.Cells.Properties.DocumentProperty customProperty2 = customProperties[1];
// Checking the type of the document property and then storing the value of the
// document property according to that type
if (customProperty2.Type == Aspose.Cells.Properties.PropertyType.String)
{
string value = customProperty2.Value.ToString();
Console.WriteLine(customProperty2.Name + " : " + value);
}

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 fileAggiungere metodo per ilCustomDocumentPropertyCollection class 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 unAspose.Cells.Properties.DocumentPropertyoggetto.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample-document-properties.xlsx");
// Retrieve a list of all custom document properties of the Excel file
Aspose.Cells.Properties.CustomDocumentPropertyCollection customProperties = workbook.Worksheets.CustomDocumentProperties;
// Adding a custom document property to the Excel file
Aspose.Cells.Properties.DocumentProperty publisher = customProperties.Add("Publisher", "Aspose");
// Saving resultant spreadsheet
workbook.Save(dataDir + "out_sample-document-properties.xlsx");

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.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
// Instantiate an object of Workbook
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample-document-properties.xlsx");
// Retrieve a list of all custom document properties of the Excel file
Aspose.Cells.Properties.CustomDocumentPropertyCollection customProperties = workbook.Worksheets.CustomDocumentProperties;
// Add link to content.
customProperties.AddLinkToContent("Owner", "MyRange");
// Accessing the custom document property by using the property name
Aspose.Cells.Properties.DocumentProperty customProperty1 = customProperties["Owner"];
// Check whether the property is lined to content
bool islinkedtocontent = customProperty1.IsLinkedToContent;
// Get the source for the property
string source = customProperty1.Source;
// Save the file
workbook.Save(dataDir + "out_sample-document-properties.xlsx");

Rimozione delle proprietà personalizzate

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

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample-document-properties.xlsx");
// Retrieve a list of all custom document properties of the Excel file
Aspose.Cells.Properties.DocumentPropertyCollection customProperties = workbook.Worksheets.CustomDocumentProperties;
// Removing a custom document property
customProperties.Remove("Publisher");
// Save the file
workbook.Save(dataDir + "out_sample-document-properties.xlsx");

Argomenti avanzati