Lavorare con le proprietà dei documenti
Le proprietà dei documenti permettono di memorizzare alcune informazioni utili sul documento. Queste proprietà possono essere divise in due gruppi:
- Sistema o incorporato che contengono valori come titolo di documento, nome dell’autore, statistiche di documento e altri.
-
Definito dall’utente o personalizzato, fornito come coppie di valori di nome in cui l’utente può definire sia il nome che il valore.
È utile sapere che le informazioni su API e il numero di versione è scritto direttamente ai documenti di uscita. Ad esempio, dopo la conversione di un documento in PDF, Aspose.Words riempie nel campo “Applicazione” con “Aspose.Words”, e il campo “Produttore PDF” con “Aspose.Words per Java YY.M.N. dove YY.M.N è la versione di Aspose.Words usato per la conversione. Per maggiori dettagli, vedere Nome generatore o produttore incluso in documenti di uscita.
Proprietà del documento di accesso
Per accedere alle proprietà dei documenti Aspose.Words uso:
-
BuiltInDocumentProperties per ottenere proprietà integrate.
-
CustomDocumentProperties per ottenere proprietà personalizzate.
BuiltInDocumentProperties e CustomDocumentProperties sono collezioni di DocumentProperty oggetti. Questi oggetti possono essere ottenuti attraverso la proprietà dell’indice per nome o per indice.
BuiltInDocumentProperties fornisce inoltre l’accesso alle proprietà documentali attraverso una serie di proprietà inserite che restituiscono i valori del tipo appropriato. CustomDocumentProperties consente di aggiungere o rimuovere le proprietà del documento da un documento.
The DocumentProperty classe consente di ottenere il nome, il valore e il tipo di proprietà di un documento. [Valore]https://reference.aspose.com/words/java/com.aspose.words/documentproperty#Value) messaggio un oggetto, ma vi è una serie di metodi che permettono di ottenere il valore della proprietà convertito in un tipo specifico. Dopo aver capito che tipo di proprietà è, è possibile utilizzare uno dei {0} i metodi, vieni {1}[ToString]](https://reference.aspose.com/words/java/com.aspose.words/documentproperty/#toString) e DocumentProperty.ToInt, ottenere il valore del tipo appropriato.
Il seguente esempio di codice mostra come enumerate tutte le proprietà integrate e personalizzate in un documento:
In Microsoft Word, è possibile accedere alle proprietà dei documenti utilizzando il menu “File → Properties”.
Aggiungere o rimuovere Proprietà del documento
Non è possibile aggiungere o rimuovere le proprietà del documento incorporato utilizzando Aspose.Words. È possibile modificare o aggiornare i propri valori.
Per aggiungere proprietà documentali personalizzate con Aspose.Words, utilizzare Add metodo, passando il nuovo nome della proprietà e il valore del tipo appropriato. Il metodo restituisce il nuovo creato DocumentProperty oggetto.
Per rimuovere le proprietà personalizzate, utilizzare Remove metodo, passando il nome della proprietà per rimuovere, o il RemoveAt metodo per rimuovere la proprietà per indice. È inoltre possibile rimuovere tutte le proprietà utilizzando Clear metodo.
Il seguente esempio di codice verifica se una proprietà personalizzata con un dato nome esiste in un documento e aggiunge alcune proprietà di documento più personalizzate:
Il seguente esempio di codice mostra come rimuovere una proprietà di documento personalizzata:
Aggiornamento Proprietà del documento integrato
Aspose.Words non aggiorna automaticamente le proprietà del documento, come Microsoft Word fa con alcune proprietà, ma fornisce un metodo per aggiornare alcune proprietà dei documenti integrati statisticamente. Chiama il UpdateWordCount metodo per ricalcolare e aggiornare le seguenti proprietà:
Creare una nuova proprietà personalizzata collegato al contenuto
Aspose.Words fornisce AddLinkToContent metodo per creare una nuova proprietà documentale personalizzata legata al contenuto. Questa proprietà restituisce l’oggetto di proprietà appena creato o null se il LinkSource è invalido.
Il seguente esempio di codice mostra come configurare un link a una proprietà personalizzata:
Ottieni Variabili di Documento
È possibile ottenere una raccolta di variabili di documento utilizzando la Variables proprieta'. I nomi e i valori variabili sono stringhe.
Il seguente esempio di codice mostra come enumerare variabili di documento:
Rimuovere i dati personali dal documento
Se si desidera condividere un documento di Word con altre persone, si può desiderare di rimuovere le informazioni personali come il nome dell’autore e la società. Per fare questo utilizzare RemovePersonalInformation proprietà per impostare la bandiera indicando che Microsoft Word rimuoverà tutte le informazioni dell’utente da commenti, revisioni e proprietà del documento al momento del salvataggio del documento.