Introduceți Câmpuri
Există mai multe moduri diferite de a insera câmpuri într-un document:
- folosind DocumentBuilder
- folosind FieldBuilder
- utilizarea Aspose.Words Model Obiect Document (DOM)
În acest articol, vom analiza fiecare mod în detaliu și vom analiza cum să inserați anumite câmpuri folosind aceste opțiuni.
Inserarea câmpurilor într-un Document folosind DocumentBuilder
În Aspose.Words metoda InsertField este utilizată pentru a insera câmpuri noi într-un document. Primul parametru acceptă codul complet al câmpului care urmează să fie introdus. Al doilea parametru este opțional și permite setarea manuală a rezultatului câmpului. Dacă acest lucru nu este furnizat, atunci câmpul este actualizat automat. Puteți trece null sau empty la acest parametru pentru a insera un câmp cu o valoare de câmp gol. Dacă nu sunteți sigur de sintaxa codului de câmp, creați mai întâi câmpul în Microsoft Word și comutați pentru a vedea codul câmpului său.
Următorul exemplu de cod arată cum să inserați un câmp de îmbinare într-un document folosind DocumentBuilder:
Aceeași tehnică este utilizată pentru a insera câmpuri imbricate în alte câmpuri.
Următorul exemplu de cod demonstrează cum să inserați câmpuri imbricate într-un alt câmp folosind DocumentBuilder:
Specificați Locale la nivel de câmp
Un identificator de limbă este o abreviere numerică internațională standard pentru limba dintr-o țară sau regiune geografică. Cu Aspose.Words, Puteți specifica Locale-ul la nivel de câmp folosind proprietatea LocaleId, care primește sau setează locale-ul câmpului ID.
Următorul exemplu de cod arată cum să utilizați această opțiune:
Introduceți Câmpul Netipat/Gol
Dacă doriți să inserați câmpuri netipate/goale ({}) la fel cum permite Microsoft Word, puteți utiliza metoda InsertField cu parametrul FieldType.FieldNone. Pentru a insera un câmp într-un document Word, puteți apăsa combinația de taste “Ctrl + F9”.
Următorul exemplu de cod arată cum să inserați un câmp gol în document:
Introduceți COMPARE
Câmp
Câmpul COMPARE
compară două valori și returnează valoarea numerică 1 dacă comparația este adevărată sau 0 dacă comparația este falsă.
Următorul exemplu de cod arată cum să adăugați COMPARE
câmpuri folosind DocumentBuilder:
Introduceți IF
Câmp
Câmpul IF
poate fi folosit pentru a evalua argumentele condiționat.
Următorul exemplu de cod arată cum să adăugați IF
câmpuri folosind DocumentBuilder:
Inserarea câmpurilor într-un Document folosind FieldBuilder
Modul alternativ de a insera câmpuri în Aspose.Words este clasa FieldBuilder. Oferă o interfață fluentă pentru a specifica comutatoarele de câmp și valorile argumentelor ca text, noduri sau chiar câmpuri imbricate.
Următorul exemplu de cod arată cum să inserați un câmp într-un document folosind FieldBuilder:
Introducerea câmpurilor folosind DOM
De asemenea, puteți insera diferite tipuri de câmpuri folosind Aspose.Words Model Obiect Document (DOM). În această secțiune, vom analiza câteva exemple.
Inserarea câmpului de îmbinare într-un Document folosind DOM
MERGEFIELD
field in Word document can be represented by the FieldMergeField class. You can use FieldMergeField class to perform the following operations:
- specificați numele câmpului de îmbinare
- specificați formatarea câmpului de îmbinare
- specificați textul care se află între separatorul de câmp și sfârșitul câmpului câmpului de îmbinare
- specificați textul care trebuie inserat după câmpul de îmbinare dacă câmpul nu este gol
- specificați textul care trebuie inserat înainte de câmpul îmbinare dacă câmpul nu este gol
Următorul exemplu de cod arată cum să adăugați câmpul MERGE
folosind DOM la un paragraf dintr-un document:
Inserarea câmpului Mail Merge ADDRESSBLOCK
într-un Document folosind DOM
Câmpul ADDRESSBLOCK
este folosit pentru a insera un bloc de adrese mail merge într-un document Word. ADDRESSBLOCK
câmpul din documentul Word poate fi reprezentat de clasa FieldAddressBlock. Puteți utiliza clasa FieldAddressBlock pentru a efectua următoarele operații:
- specificați dacă să includeți numele țării/regiunii în câmp
- specificați dacă să formatați adresa în funcție de țara / regiunea destinatarului, astfel cum este definită de POST * CODE (Uniunea Poștală Universală 2006)
- specificați numele țării/regiunii excluse
- specificați formatul numelui și adresei
- specificați limba ID utilizată pentru formatarea adresei
Următorul exemplu de cod arată cum să adăugați câmpul Mail Merge ADDRESSBLOCK
folosind DOM la un paragraf dintr-un document:
Inserarea câmpului ADVANCE
într-un Document fără a utiliza DocumentBuilder
Câmpul ADVANCE
este folosit pentru a compensa textul ulterior într-o linie la stânga, la dreapta, în sus sau în jos. ADVANCE
câmpul din documentul Word poate fi reprezentat de clasa FieldAdvance. Puteți utiliza clasa FieldAdvance pentru a efectua următoarele operații:
- specificați numărul de puncte prin care textul care urmează câmpului trebuie mutat vertical de la marginea superioară a paginii
- specificați numărul de puncte prin care textul care urmează câmpului trebuie mutat orizontal de la marginea stângă a coloanei, cadrului sau casetei de text
- specificați numărul de puncte prin care textul care urmează câmpului trebuie mutat la stânga, la dreapta, în sus sau în jos
Următorul exemplu de cod arată cum să adăugați câmpul ADVANCE
folosind DOM la un paragraf dintr-un document:
Inserarea câmpului ASK
într-un Document fără a utiliza DocumentBuilder
Câmpul ASK
este folosit pentru a solicita utilizatorului ca textul să fie atribuit unui marcaj în documentul Word. ASK
câmpul din documentul Word poate fi reprezentat de clasa FieldAsk. Puteți utiliza clasa FieldAsk pentru a efectua următoarele operații:
- specificați numele marcajului
- specificați răspunsul implicit al utilizatorului (valoarea inițială conținută în fereastra prompt)
- specificați dacă răspunsul utilizatorului trebuie primit o dată pentru o operație mail merge
- specificați textul prompt (titlul ferestrei prompt)
Următorul exemplu de cod arată cum să adăugați câmpul ASK
folosind DOM la un paragraf dintr-un document:
Inserarea câmpului AUTHOR
într-un Document fără a utiliza DocumentBuilder
Câmpul AUTHOR
este folosit pentru a specifica numele autorului documentului din proprietățile Document
. AUTHOR
câmpul din documentul Word poate fi reprezentat de clasa FieldAuthor. Puteți utiliza clasa FieldAuthor pentru a efectua următoarele operații:
- specificați numele autorului documentului
Următorul exemplu de cod arată cum să adăugați câmpul AUTHOR
folosind DOM la un paragraf dintr-un document:
Inserarea câmpului INCLUDETEXT
într-un Document fără a utiliza DocumentBuilder
Câmpul INCLUDETEXT
introduce textul și grafica conținute în documentul numit în codul câmpului. Puteți insera întregul document sau o porțiune a documentului la care se face referire printr-un marcaj. Acest câmp din documentul Word este reprezentat de INCLUDETEXT. Puteți utiliza clasa FieldIncludeText pentru a efectua următoarele operații:
- specificați numele marcajului documentului inclus
- specificați locația documentului
Următorul exemplu de cod arată cum să adăugați câmpul INCLUDETEXT
folosind DOM la un paragraf dintr-un document:
Inserarea câmpului TOA
într-un Document fără a utiliza DocumentBuilder
Câmpul TOA
(Table of Authorities) construiește și introduce un tabel de autorități. Câmpul TOA
colectează intrările marcate cu câmpurile TA
(Table of Authorities Entry). Microsoft Office Word introduce câmpul TOA
Când faceți clic pe Insert Table of Authorities în grupul Table of Authorities din fila References. Când vizualizați câmpul TOA
din document, sintaxa arată astfel:
{ TOA
[Switches ] }
Următorul exemplu de cod arată cum să adăugați câmpul TOA
folosind DOM la un paragraf dintr-un document.