Lucrați cu proprietățile documentului
Proprietățile documentului permit stocarea unor informații utile despre documentul dvs. Aceste proprietăți pot fi împărțite în două grupe:
- Sistem sau încorporat care conține valori precum titlul documentului, numele autorului, Statisticile documentelor și altele.
- Definite de utilizator sau personalizate, furnizate ca perechi nume-valoare în care utilizatorul poate defini atât numele, cât și valoarea.
Este util să știți că informațiile despre API și numărul versiunii sunt scrise direct în documentele de ieșire. De exemplu, la conversia unui document în PDF, Aspose.Words completează câmpul “aplicație” cu " Aspose.Words", iar câmpul" PDF Producător “cu"Aspose.Words pentru Java YY.M. N”, unde YY.M.N este versiunea Aspose.Words folosită pentru conversie. Pentru mai multe detalii, a se vedea Numele generatorului sau al producătorului inclus în documentele de ieșire.
Accesați Proprietățile Documentului
Pentru a accesa proprietățile documentului în Aspose.Words utilizați:
-
BuiltInDocumentProperties pentru a obține proprietăți încorporate.
-
CustomDocumentProperties pentru a obține proprietăți personalizate.
BuiltInDocumentProperties
BuiltInDocumentProperties
Clasa DocumentProperty vă permite să obțineți numele, valoarea și tipul unei proprietăți De document. [Value]https://reference.aspose.com/words/java/com.aspose.words/documentproperty#Value) returns an object, but there is a set of methods allowing you to get the property value converted to a specific type. After you get to know what type the property is, you can use one of the DocumentProperty.ToXXX methods, such as DocumentProperty.ToString și DocumentProperty.ToInt, pentru a obține valoarea tipului corespunzător.
Următorul exemplu de cod arată cum să enumerați toate proprietățile încorporate și personalizate într-un document:
În Microsoft Word, puteți accesa proprietățile documentului utilizând meniul “Proprietăți fișier 3”.
Adăugați sau eliminați proprietățile documentului
Nu puteți adăuga sau elimina proprietățile documentului încorporat folosind Aspose.Words. Puteți modifica sau actualiza doar valorile lor.
Pentru a adăuga proprietăți personalizate ale documentului cu Aspose.Words, Utilizați metoda Add, trecând noul nume de proprietate și valoarea tipului corespunzător. Metoda returnează obiectul DocumentProperty nou creat.
Pentru a elimina proprietățile personalizate, Utilizați metoda Remove, trecând numele proprietății de eliminat sau metoda RemoveAt pentru a elimina proprietatea prin index. De asemenea, puteți elimina toate proprietățile folosind metoda Clear.
Următorul exemplu de cod verifică dacă o proprietate personalizată cu un nume dat există într-un document și adaugă câteva proprietăți De document personalizate:
Următorul exemplu de cod arată cum să eliminați o proprietate document personalizat:
Actualizați Proprietățile Documentului Încorporat
Aspose.Words nu actualizează automat proprietățile documentului, așa cum face Microsoft Word cu unele proprietăți, dar oferă o metodă de actualizare a unor proprietăți statistice încorporate ale documentului. Apelați metoda UpdateWordCount pentru a recalcula și actualiza următoarele proprietăți:
Creați o nouă proprietate personalizată legată de conținut
Aspose.Words oferă metoda AddLinkToContent pentru a crea o nouă proprietate document personalizat legat de conținut. Această proprietate returnează obiectul de proprietate nou creat sau null dacă LinkSource este nevalid.
Următorul exemplu de cod arată cum să configurați un link către o proprietate personalizată:
Obțineți Variabile De Document
Puteți obține o colecție de variabile de document folosind proprietatea Variables. Numele și valorile variabilelor sunt șiruri.
Următorul exemplu de cod arată cum să enumerați variabilele documentului:
Eliminați informațiile personale din Document
Dacă doriți să partajați un document Word cu alte persoane, vă recomandăm să eliminați informații personale, cum ar fi numele autorului și compania. Pentru a face acest lucru, utilizați proprietatea RemovePersonalInformation pentru a seta steagul care indică faptul că Microsoft Word va elimina toate informațiile utilizatorului din comentarii, revizuiri și proprietăți ale documentului la salvarea documentului.