Lucrează cu Proprietățile Documentului
Proprietățile documentului permit stocarea unor informații utile despre documentul dumneavoastră. Aceste proprietăți pot fi împărțite în două grupuri:
- Sistem sau încorporat care conține valori precum titlul documentului, numele autorului, statistici ale documentului și altele.
- Definit de utilizator sau particular, furnizat ca perechi cu nume și 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 de versiune sunt scrise direct în documentele de ieșire. De exemplu, la convertirea unui document în format PDF, Aspose.Words completează câmpul “Aplicație” cu “Aspose.Words”, și câmpul “PDF Producer” cu “Aspose.Words pentru .NET YY.M.N”, unde YY.M.N reprezintă versiunea de Aspose.Words folosită pentru conversie. Pentru detalii suplimentare, vezi Generator or Producer Name Included in Output Documents.
Accesați proprietățile documentului
Pentru a accesa proprietățile documentului în Aspose.Words utilizați:
-
BuiltInDocumentProperties pentru a obține proprietățile încorporate.
-
CustomDocumentProperties pentru a obține proprietăți personalizate.
BuiltInDocumentProperties și CustomDocumentProperties sunt colecții de DocumentProperty obiecte. Aceste obiecte pot fi obținute prin proprietatea indexatorului, fie după nume, fie după indice.
BuiltInDocumentProperties oferă în plus acces la proprietățile documentului printr-un set de proprietăți introduse care returnează valori de tip corespunzător. " CustomDocumentProperties vă permit să adăugați sau să eliminați proprietăți ale documentului dintr-un document.
Clasa DocumentProperty permite să obţii numele, valoarea şi tipul unei proprietăţi de document. Value returnează un obiect, dar există o serie de metode care îţi permit să obţii valoarea proprietăţii convertită într-un anumit tip. După ce știi ce tip este proprietatea, poți folosi una din DocumentProperty.ToXXX metode, precum DocumentProperty.ToString și DocumentProperty.ToInt, pentru a obține valoarea de tip corespunzător.
Exemplul de cod următor arată cum să enumerăm toate proprietățile încorporate și personalizate într-un document:
În Microsoft Word poţi accesa proprietăţile unui document folosind meniul “Fișier - Proprietăți”.
Adaugă sau șterge proprietățile documentului
Nu poți adăuga sau elimina proprietăți de document încorporate folosind Aspose.Words. Puteți schimba sau actualiza doar valorile lor.
Pentru a adăuga proprietăți personalizate ale documentului cu Aspose.Words, utilizați metoda Add, trecând numele noii proprietăți și valoarea de tipul corespunzător. Metoda returnează obiectul nou creat DocumentProperty.
Pentru a elimina proprietățile personalizate, utilizați metoda Remove, trecând numele proprietății care urmează să fie eliminată, sau metoda RemoveAt, pentru a elimina proprietatea după indice. Puteți, de asemenea, să eliminați toate proprietățile folosind metoda Clear.
Exemplul de cod următor verifică dacă o proprietate personalizată cu un nume dat există într-un document și adaugă câteva mai multe proprietăți personalizate ale documentului:
Exemplul de cod următor arată cum să elimini o proprietate personalizată a documentului:
Actualizează proprietățile documentului nativ
Aspose.Words nu actualizează automat proprietățile documentului, așa cum face Microsoft Word cu unele proprietăți, dar oferă o metodă de a actualiza anumite proprietăți încorporate ale documentului. Apelați metoda UpdateWordCount pentru a recalcula și actualiza următoarele proprietăți:
Creați o proprietate personalizată nouă legată de conținut
“Aspose.Words oferă metoda AddLinkToContent pentru crearea unei noi proprietăți personalizate de document legată de conținut.” Această proprietate returnează obiectul de proprietate nou creat sau nul dacă LinkSource este nevalid.
Exemplul următor de cod arată cum să configurați o legătură către o proprietate particularizată:
Obține variabilele documentului
Puteţi obţine o colecţie de variabile de document folosind proprietatea Variables. Nume și valori de variabile sunt șiruri.
Exemplul următor de cod arată cum să enumerăm variabilele documentului:
Elimina informaţiile personale din document
Dacă doriți să împărtășiți un document Word cu alți oameni, s-ar putea să doriți să eliminați informații personale, cum ar fi numele autorului și numele companiei. Pentru a face acest lucru utilizați proprietatea RemovePersonalInformation pentru a seta steagul care indică faptul că Microsoft Word va șterge toate informațiile utilizatorului din comentarii, revizuiri și proprietăți de documente la salvarea documentului.
Exemplul de cod următor arată cum să se elimine informațiile personale: