Lavorare con le proprietà del documento
Le proprietà del documento consentono di memorizzare alcune informazioni utili sul documento. Queste proprietà possono essere divise in due gruppi:
- Sistema o built-in che contengono valori come titolo del documento, nome dell’autore, statistiche del documento e altri.
- Definito dall’utente o personalizzato, fornito come coppie nome-valore in cui l’utente può definire sia il nome che il valore.
È utile sapere che le informazioni sull’API e sul numero di versione sono scritte direttamente nei documenti di output. Ad esempio, quando si converte un documento in PDF, Aspose.Words riempie il campo “Applicazione” con “Aspose.Words” e il campo “PDF Produttore " con “Aspose.Words per C++ YY.M. N”, dove YY.M.N è la versione di Aspose.Words utilizzata per la conversione. Per maggiori dettagli, vedere Nome del generatore o del produttore incluso nei documenti di output.
Accedere alle proprietà del documento
Per accedere alle proprietà del documento in Aspose.Words utilizzare:
-
BuiltInDocumentProperties per ottenere proprietà incorporate.
-
CustomDocumentProperties per ottenere proprietà personalizzate.
BuiltInDocumentProperties
BuiltInDocumentProperties
La classe DocumentProperty consente di ottenere il nome, il valore e il tipo di una proprietà del documento. Value restituisce un oggetto, ma esiste una serie di metodi che consentono di ottenere il valore della proprietà convertito in un tipo specifico. Dopo aver appreso il tipo di proprietà, è possibile utilizzare uno dei metodi DocumentProperty.ToXXX, ad esempio DocumentProperty.ToString e DocumentProperty.ToInt, per ottenere il valore del tipo appropriato.
L’esempio di codice seguente mostra come enumerare tutte le proprietà predefinite e personalizzate in un documento:
In Microsoft Word, è possibile accedere alle proprietà del documento utilizzando il menu “File → Proprietà”.
Aggiungere o rimuovere le proprietà del documento
Non è possibile aggiungere o rimuovere le proprietà predefinite del documento utilizzando Aspose.Words. Puoi solo modificare o aggiornare i loro valori.
Per aggiungere proprietà personalizzate del documento con Aspose.Words, utilizzare il metodo Add, passando il nuovo nome della proprietà e il valore del tipo appropriato. Il metodo restituisce l’oggetto DocumentProperty appena creato.
Per rimuovere le proprietà personalizzate, utilizzare il metodo Remove, passandogli il nome della proprietà da rimuovere o il metodo RemoveAt per rimuovere la proprietà per indice. È inoltre possibile rimuovere tutte le proprietà utilizzando il metodo Clear.
Il seguente esempio di codice controlla se una proprietà personalizzata con un nome specificato esiste in un documento e aggiunge alcune altre proprietà personalizzate del documento:
L’esempio di codice seguente mostra come rimuovere una proprietà documento personalizzata:
Aggiorna le proprietà del documento incorporate
Aspose.Words non aggiorna automaticamente le proprietà del documento, come fa Microsoft Word con alcune proprietà, ma fornisce un metodo per aggiornare alcune proprietà statistiche predefinite del documento. Chiamare il metodo UpdateWordCount per ricalcolare e aggiornare le seguenti proprietà:
Creare una nuova proprietà personalizzata collegata al contenuto
Aspose.Words fornisce il metodo AddLinkToContent per creare una nuova proprietà documento personalizzata collegata al contenuto. Questa proprietà restituisce l’oggetto proprietà appena creato o null se LinkSource non è valido.
L’esempio di codice seguente mostra come configurare un collegamento a una proprietà personalizzata:
Ottieni variabili documento
È possibile ottenere una raccolta di variabili del documento utilizzando la proprietà Variables. I nomi e i valori delle variabili sono stringhe.
L’esempio di codice seguente mostra come enumerare le variabili del documento:
Rimuovere le informazioni personali dal documento
Se si desidera condividere un documento Word con altre persone, è possibile rimuovere le informazioni personali come il nome dell’autore e la società. A tale scopo, utilizzare la proprietà RemovePersonalInformation per impostare il flag che indica che Microsoft Word rimuoverà tutte le informazioni dell’utente da commenti, revisioni e proprietà del documento al momento del salvataggio del documento.
Il seguente esempio di codice mostra come rimuovere le informazioni personali: