Înserare câmpuri

Există mai multe modalități diferite de a introduce câmpuri într-un document:

În acest articol vom vedea fiecare metodă în detaliu și vom analiza cum se introduc anumite câmpuri folosind aceste opțiuni.

Introducerea câmpurilor într-un document folosind DocumentBuilder

În Aspose.Words, metoda InsertField este folosită pentru inserarea unor câmpuri noi într-un document. “Prima paramentare acceptă codul complet de câmp al câmpului care urmează să fie introdus.” “Al doilea parametru este opțional și permite ca rezultatul câmpului să fie setat manual.” Dacă acest lucru nu este furnizat atunci câmpul este actualizat automat. Poţi trece null sau gol la acest parametru pentru a insera un câmp cu o valoare de câmp goală. Dacă nu eşti sigur de sintaxa codului câmpului specific, creează câmpul în Microsoft Word mai întâi şi comută pentru a vedea codul câmpului său.

Exemplul de cod următor arată cum să insereze un câmp de fuziune într-un document folosind DocumentBuilder:

Aceeași tehnică se folosește pentru a introduce câmpuri încorporate în alte câmpuri.

Exemplul următor de cod arată cum să insereze câmpuri încorporate într-un alt câmp folosind DocumentBuilder":

Specificați “Locale” la nivelul câmpului

Un identificator de limbă este o abreviere numerică internațională standard pentru limba dintr-o țară sau regiune geografică. Cu Aspose.Words, puteți specificaLocale la nivel de câmp folosind proprietatea LocaleId, care obține sau stabilește ID-ul local al câmpului.

Exemplul de cod următor arată cum să folosești această opțiune:

Introduceți câmp neclasificat/gol

Dacă doriți să inserați câmpuri ne-tipate/goale ( {} ) doar ca Microsoft Word permite, puteți folosi metoda InsertField cu parametrul FieldType.FieldNone. Pentru a introduce un câmp într-un document Word puteți apăsa combinația de taste “Ctrl + F9”.

Exemplul de cod următor arată cum să inserezi un câmp gol în document:

Inserarea câmpurilor într-un document folosind FieldBuilder

“Modul alternativ de a insera câmpuri în Aspose.Words este clasa FieldBuilder.” Acesta oferă o interfață fluidă pentru a specifica comutatoare de câmpuri și valori de argumente ca text, noduri sau chiar câmpuri încastrate.

Exemplul de cod următor arată cum să introduceți un câmp într-un document utilizând FieldBuilder:"

Inserarea câmpurilor folosind DOM

“Puteți introduce și diferite tipuri de câmpuri folosind Aspose.Words Document Object Model (DOM)”. În această secţiune, vom privi câteva exemple.

Inserarea unui câmp de fuziune într-un document folosind DOM

“Câmpul MERGEFIELD din documentul Word poate fi reprezentat de clasa FieldMergeField.” Puteți utiliza clasa FieldMergeField pentru a efectua următoarele operații:

  • specifica numele câmpului de fuziune
  • specificaţi formatarea câmpului de fuziune
  • specificați textul care este între separatorul câmpului și sfârșitul câmpului de fuziune
  • specifica textul care urmează să fie inserat după câmpul de fuziune dacă câmpul nu este gol
  • specificaţi textul ce urmează să fie inserat înaintea câmpului de fuziune dacă acesta nu este gol

Exemplul următor arată cum să adăugați câmpul MERGE utilizând DOM la un paragraf într-un document:

Inserarea Mail Merge ADDRESSBLOCK câmp într-un document folosind DOM

Câmpul ADDRESSBLOCK este utilizat pentru inserarea unui bloc de adresă Mail Merge în documentul Word. Câmpul ADDRESSBLOCK din documentul Word poate fi reprezentat de clasa FieldAddressBlock. Poţi folosi 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 conformitate cu țara/regiunea destinatarului așa cum este definită de POST*CODE (Uniunea Poștală Universală din 2006).”
  • specifica numele ţării/regiunii excluse “- specifică numele și formatul adresei”
  • specificați ID-ul limbii utilizate pentru a formata adresa de e-mail

Exemplul de cod următor arată cum să adăugați câmpul Mail Merge ADDRESSBLOCK utilizând DOM la un paragraf într-un document:

Inserarea ADVANCE câmp într-un document fără să folosești DocumentBuilder

Câmpul ADVANCE este utilizat pentru a deplasa textul următor într-o linie la stânga, dreapta, sus sau jos. Campul ADVANCE 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 ar trebui deplasat vertical de la marginea superioară a paginii
  • specificaţi numărul de puncte prin care textul care urmează câmpului ar trebui să fie deplasat orizontal din stânga marginii coloanei, cadrului sau casetei de text
  • specificați numărul de puncte prin care textul ce urmează câmpului ar trebui să fie deplasat spre stânga, dreapta, sus sau jos

Exemplul de cod următor arată cum să adăugați câmpul ADVANCE folosind DOM la un paragraf dintr-un document:

Introducerea unui câmp ASK într-un document fără utilizarea DocumentBuilder

Câmpul ASK se foloseşte pentru a solicita utilizatorului textul care să fie atribuit unei Semnări în documentul Word. Câmpul ASK din documentul Word poate fi reprezentat de clasa FieldAsk. Puteți folosi clasa FieldAsk pentru a efectua următoarele operații:

“- specificați numele semnului de carte”

  • specificați răspunsul implicite al utilizatorului (valoarea inițială conținută în fereastra de solicitare)
  • specificaţi dacă răspunsul utilizatorului trebuie să fie primit o dată pe o Mail Merge operaţie
  • specifica textul de introducere (titlul ferestrei de introducere)

Exemplul de cod următor prezintă modul în care să adăugați ASK Câmp utilizând DOM la un paragraf într-un document:

Inserarea câmpului AUTHOR într-un document fără a folosi DocumentBuilder

Câmpul AUTHOR se folosește pentru a specifica numele autorului documentului din Document proprietăți. Câmpul AUTHOR 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

Exemplul următor de cod arată cum să adăugați câmpul AUTHOR folosind DOM la un paragraf într-un document:

Introducerea unui câmp INCLUDETEXT într-un document fără a folosi DocumentBuilder

Câmpul INCLUDETEXT inserează textul și grafiile din documentul numit în codul câmpului. Puteți insera întregul document sau o porțiune a acestuia care este referit de un marcaj. Acest câmp în documentul Word este reprezentat de INCLUDETEXT. Puteți utiliza clasa FieldIncludeText pentru a efectua următoarele operații:

  • specificaţi numele semnului de carte pentru documentul inclus
  • specificaţi locaţia documentului

Exemplul de cod următor arată cum să adaugăm câmpul INCLUDETEXT utilizând DOM la un paragraf într-un document:

Introducerea TOA câmpului într-un document fără a utiliza DocumentBuilder

The TOA (Tabelul de autorități) câmp construiește și inserează un tabel de autorități. The TOA câmp colectează intrări marcate cu TA (Intrare Tabelul de Autorități) câmpuri. Microsoft Office Word introduce câmpul TOA când faceți clic pe Insert Table of Authorities în grupul Tabelul autorităților pe fila References. Când vizualizați câmpul TOA în documentul dvs., sintaxa arată așa:

{ TOA [Switches ] }

Exemplul de cod următor arată cum să adaugeți câmpul TOA folosind DOM într-un paragraf dintr-un document:

Câmpuri în C# Cum să găseşti proprietăţile câmpurilor în C#?