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.

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

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.

1. DalFile menù, selezionareInformazioni.

Selezionando Menu Informazioni

1. Clicca suProprietàvoce 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à, 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.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xls");
 
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Accessing a custom document property by using the property name
DocumentProperty customProperty1 = customProperties.get("ContentTypeId");
 
System.out.println(customProperty1.getName() + " " + customProperty1.getValue());
 
// Accessing a custom document property by using the property index
DocumentProperty customProperty2 = customProperties.get(0);
 
System.out.println(customProperty2.getName() + " " + customProperty2.getValue());

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.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xls");
 
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Accessing a custom document property
DocumentProperty customProperty1 = customProperties.get(0);
 
// Storing the value of the document property as an object
Object objectValue = customProperty1.getValue();
 
// Accessing a custom document property
DocumentProperty customProperty2 = customProperties.get(1);
 
// Checking the type of the document property and then storing the value of the
// document property according to that type
if (customProperty2.getType() == PropertyType.STRING)
{
  String value = customProperty2.getValue().toString();
}

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.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
 
// Retrieve a list of all custom document properties of the Excel file
CustomDocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Adding a custom document property to the Excel file
DocumentProperty publisher = customProperties.add("Publisher", "Aspose");

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.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
 
// Retrieve a list of all custom document properties of the Excel file
CustomDocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Add link to content.
customProperties.addLinkToContent("Owner", "MyRange");
 
// Accessing the custom document property by using the property name
DocumentProperty customProperty1 = customProperties.get("Owner");
 
// Check whether the property is lined to content
Boolean islinkedtocontent = customProperty1.isLinkedToContent();
 
// Get the source for the property
String source = customProperty1.getSource();

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.

// For complete examples and data files, please go to https://github.com/aspose-tasks/Aspose.Cells-for-Java
// Instantiate a Workbook object
// Open an Excel file
Workbook workbook = new Workbook(dataDir + "sample.xlsx");
 
// Retrieve a list of all custom document properties of the Excel file
DocumentPropertyCollection customProperties = workbook.getWorksheets().getCustomDocumentProperties();
 
// Removing a custom document property
customProperties.remove("Publisher");