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 .NET 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:
-
built_in_document_properties pentru a obține proprietăți încorporate.
-
custom_document_properties pentru a obține proprietăți personalizate.
built_in_document_properties și custom_document_properties sunt colecții de obiecte DocumentProperty. Aceste obiecte pot fi obținute prin proprietatea indexatorului după nume sau după index.
built_in_document_properties oferă în plus acces la proprietățile documentului printr-un set de proprietăți introduse care returnează valori de tipul corespunzător. custom_document_properties vă permite să adăugați sau să eliminați proprietățile documentului dintr-un document.
Clasa DocumentProperty vă permite să obțineți numele, valoarea și tipul unei proprietăți De document. value returnează un obiect, dar există un set de metode care vă permit să obțineți valoarea proprietății convertită la un anumit tip. După ce aflați ce tip este proprietatea, puteți utiliza una dintre metodele DocumentProperty.to_XXX, cum ar fi DocumentProperty.__str__ și DocumentProperty.to_int, 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ându-i numele proprietății de eliminat sau metoda remove_at 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 update_word_count pentru a recalcula și actualiza următoarele proprietăți:
Creați o nouă proprietate personalizată legată de conținut
Aspose.Words oferă metoda add_link_to_content pentru a crea o nouă proprietate document personalizat legat de conținut. Această proprietate returnează obiectul de proprietate nou creat sau null dacă link_source 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ă adăugați și să accesaț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 remove_personal_information 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.
Următorul exemplu de cod arată cum să eliminați informațiile personale: