Вмъкване на полета

Има няколко различни начина за вмъкване на полета в документ:

В тази статия ще разгледаме по-подробно всеки начин и ще анализираме как да вмъкнем определени полета, използвайки тези опции.

Вмъкване на полета в документ с помощта на Document Builder

В Aspose.Words на InsertField метод се използва за въвеждане на нови полета в документ. Първият параметър приема да бъде поставен пълният код на полето. Вторият параметър е незадължителен и позволява ръчно да се зададе резултатът от полето. Ако това не е доставено, полето се актуализира автоматично. Можете да преминете нула или празно към този параметър, за да въведете поле с празна стойност на полето. Ако не сте сигурни за конкретния код синтаксис, създайте полето в Microsoft Word Първо превключи, за да видиш кода на полето.

Следният пример за код показва как да се вмъкне поле за сливане в документ, като се използва DocumentBuilder:

Същата техника се използва за вмъкване на полета в други полета.

Следният пример за код показва как да вмъкнете полета в друго поле, като използвате DocumentBuilder:

Посочване на местоположението на ниво поле

Езиковият идентификатор е стандартно международно цифрово съкращение за езика в държава или географски регион. С Aspose.Words, Можете да посочите Locale на нивото на полето с помощта на LocaleId имот, който получава или определя местоположението на полето.

Следният пример за код показва как да използвате тази опция:

Вмъкване на нетипично/специфично поле

Ако искате да въведете нетипизирани/празни полета ({}) Точно като Microsoft Word позволява, можете да използвате InsertField метод с FieldType.FieldNone параметър. За да вмъкнете поле в Word документ, можете да натиснете Ctrl + F9.

Следният пример за код показва как да се постави празно поле в документа:

Вмъкване COMPARE Поле

На COMPARE полето сравнява две стойности и връща числовата стойност 1, ако сравнението е true или 0, ако сравнението е false.

Следният пример с код показва как да добавите COMPARE полета, използващи DocumentBuilder:

Вмъкване IF Поле

На IF полето може да се използва за оценка на аргументите условно.

Следният пример с код показва как да добавите IF полета, използващи DocumentBuilder:

Вмъкване на полета в документ с помощта на fieldbuilder

Алтернативен начин за вмъкване на полета в Aspose.Words е FieldBuilder Клас. Той осигурява перфектен интерфейс за определяне на полеви превключватели и спорни стойности като текст, възли или дори гнезда полета.

Следният пример за код показва как да се въведе поле в документ, като се използва FieldBuilder:

Вмъкване на полета DOM

Можете също така да вмъквате различни видове полета, използвайки Aspose.Words Document Object Model (DOM). В този раздел ще разгледаме няколко примера.

Вмъкване на сливане Поле в документ, използващ DOM

MERGEFIELD полето в документа на Word може да бъде представено от FieldMergeField Клас. Можеш да използваш FieldMergeField клас за извършване на следните операции:

  • посочете името на полето за сливане
  • посочете форматирането на полето за сливане
  • посочете текста, който е между разделителя на полето и края на полето на сливането
  • посочете текста, който трябва да се вмъкне след сливането, ако полето не е празно
  • посочете текста, който ще бъде поставен преди сливането на полето, ако полето не е празно

Следният пример с код показва как да добавите MERGE поле за използване DOM към параграф в документ:

Вмъкване Mail Merge ADDRESSBLOCK поле в документ, използващ DOM

На ADDRESSBLOCK поле се използва за вмъкване на mail merge адрес блок в Word документ. ADDRESSBLOCK полето в документа на Word може да бъде представено от FieldAddressBlock Клас. Можеш да използваш FieldAddressBlock клас за извършване на следните операции:

  • посочете дали да включите името на страната/региона в полето
  • да се уточни дали да се форматира адресът според държавата/региона на получателя, както е определен от POST*CODE (Универсален пощенски съюз 2006)
  • посочете името на страната/региона
  • посочете името и формата на адреса
  • посочете езика ID, използван за форматиране на адреса

Следният пример с код показва как да добавите Mail Merge ADDRESSBLOCK Използване на поле DOM към параграф в документ:

Вмъкване ADVANCE поле в документ без използване на DocumentBuilder

На ADVANCE полето се използва за компенсиране на последващия текст в линия наляво, надясно, нагоре или надолу. ADVANCE полето в документа на Word може да бъде представено от FieldAdvance Клас. Можеш да използваш FieldAdvance клас за извършване на следните операции:

  • посочете броя на точките, с които текстът, който следва полето трябва да се премества вертикално от горния край на страницата
  • посочете броя на точките, с които текстът, който следва полето трябва да се премества хоризонтално от левия край на колоната, рамката или текстовата кутия
  • посочете броя на точките, с които текстът, който следва полето, трябва да се премести наляво, надясно, нагоре или надолу

Следният пример с код показва как да добавите ADVANCE Използване на поле DOM към параграф в документ:

Вмъкване ASK поле в документ без използване на DocumentBuilder

На ASK полето се използва за подканване на потребителя за текст за присвояване на отметка в Word документ. ASK полето в документа на Word може да бъде представено от FieldAsk Клас. Можеш да използваш FieldAsk клас за извършване на следните операции:

  • посочете името на отметките
  • посочете отговора на потребителя по подразбиране (първоначална стойност, съдържаща се в бързия прозорец)
  • посочете дали потребителският отговор трябва да се получи веднъж на a mail merge експлоатация
  • да се посочи бърз текст (титуляр на бърз прозорец)

Следният пример с код показва как да добавите ASK Използване на поле DOM към параграф в документ:

Вмъкване AUTHOR поле в документ без използване на DocumentBuilder

На AUTHOR поле се използва за определяне на името на автора на документа от Document имоти. AUTHOR полето в документа на Word може да бъде представено от FieldAuthor Клас. Можеш да използваш FieldAuthor клас за извършване на следните операции:

  • посочете името на автора на документа

Следният пример с код показва как да добавите AUTHOR Използване на поле DOM към параграф в документ:

Вмъкване INCLUDETEXT поле в документ без използване на DocumentBuilder

На INCLUDETEXT полето вмъква текста и графиките, съдържащи се в документа, посочен в кода на полето. Можете да поставите целия документ или част от документа, посочен с отметки. Тази област в Word документ е представена от ВКЛЮЧИТЕЛНО ЕТЕКСТ. Можеш да използваш FieldIncludeText клас за извършване на следните операции:

  • посочете името на отметките на включения документ
  • посочете местоположението на документа

Следният пример с код показва как да добавите INCLUDETEXT поле за използване DOM към параграф в документ:

Вмъкване TOA поле в документ без използване на DocumentBuilder

На TOA (Таблица на органите) полето изгражда и вмъква таблица от органи. На TOA поле събира записи, маркирани с TA (Таблица на органите за влизане) полета. Microsoft Office Word вмъква TOA поле, когато кликнете * Таблица на органите група на References Сметка. Когато видите TOA В този документ синтаксисът изглежда така:

{ TOA [Switches ] }

Следният пример с код показва как да добавите TOA поле за използване DOM на параграф в документ.