Introduceți Câmpuri

Există mai multe moduri diferite de a insera câmpuri într-un document:

Î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.