--- title: "Вставити поля в C#" --- Є кілька різних способів вставити поля в документ: * використання [DocumentBuilder](https://reference.aspose.com/words/net/aspose.words/documentbuilder/) * використання [FieldBuilder](https://reference.aspose.com/words/net/aspose.words.fields/fieldbuilder/) * використання [Aspose.Words Document Object Model (DOM)](/words/uk/net/aspose-words-document-object-model/) У цій статті ми розглянемо кожен спосіб більш детально і аналізуємо, як вставляти певні поля за допомогою цих параметрів. ## Введення полів у документ з використанням DocumentBuilder У Aspose.Words Про нас [InsertField](https://reference.aspose.com/words/net/aspose.words/documentbuilder/insertfield/) метод використовується для вставки нових полів в документ. Перший параметр приймає повне поле коду поля, щоб бути вставленим. Другий параметр є обов'язковим і дозволяє польовий результат поля, щоб встановити вручну. Якщо це не подається, то поле автоматично оновлюється. Ви можете пройти null або порожній до цього параметра, щоб вставити поле з порожнім значенням поля. Якщо ви не впевнені, що конкретний код поля синтаксису, створюємо поле в Microsoft Word спочатку і переключіть, щоб побачити свій код поля. ``` Якщо ваш код поля має параметр, який містить простір, то він повинен бути закритий в межах мовних знаків. В іншому випадку поле в обох Microsoft Word і Aspose.Words не може працювати, як очікується, як параметр лікується як при truncated. ``` Приклад наступного коду показує, як вставити поле злиття в документ, використовуючи **DocumentBuilder**: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertField-InsertField.cs" >}} Така ж техніка використовується для вставок полів, що приводяться в інші поля. Наприклад, наступний код показує, як вставити поля, що містяться в іншому полі за допомогою **DocumentBuilder**: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertNestedFields-InsertNestedFields.cs" >}} ### Вказати місцевість на рівні поля English, Українська, Français... З Aspose.Words, Ви можете вказати Locale на рівні поля, використовуючи [LocaleId](https://reference.aspose.com/words/net/aspose.words.fields/field/localeid/) майно, яке отримує або встановлює місцевий ідентифікатор поля. Приклад наступного коду показує, як використовувати цей варіант: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-SpecifylocaleAtFieldlevel-SpecifylocaleAtFieldlevel.cs" >}} ### Вставити нетипове поле Якщо ви хочете вставити нетипові / порожні поля ({}) так само як Microsoft Word дозволяє, ви можете використовувати [InsertField](https://reference.aspose.com/words/net/aspose.words/documentbuilder/insertfield/) метод з [FieldType.FieldNone](https://reference.aspose.com/words/net/aspose.words.fields/fieldtype/) параметр. Щоб вставити поле в документ Word, ви можете натиснути клавішу "Ctrl + F9". Приклад коду показує, як вставити порожні поля в документ: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertFieldNone-InsertFieldNone.cs" >}} ## Введення полів в документ з використанням FieldBuilder Альтернативний спосіб вставити поля в Aspose.Words є [FieldBuilder](https://reference.aspose.com/words/net/aspose.words.fields/fieldbuilder/) клас. Він надає швидкий інтерфейс, щоб вказати значення поля та значення аргументів, як текст, вершини або навіть вкладені поля. Приклад наступного коду показує, як вставити поле в документ, використовуючи **FieldBuilder**: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertFieldUsingFieldBuilder.cs" >}} ## Вставки поля з використанням DOM Ви також можете вставляти різні види полів [Aspose.Words Document Object Model (DOM)](/words/uk/net/aspose-words-document-object-model/)й В цьому розділі ми розглянемо кілька прикладів. ### Вставки Поле в документ з використанням DOM Про нас `MERGEFIELD` поле в документі Word може бути представлений [FieldMergeField](https://reference.aspose.com/words/net/aspose.words.fields/fieldmergefield/) клас. Ви можете використовувати **FieldMergeField** Клас виконання наступних операцій: - вказати ім'я поля злиття - вказати форматування поля злиття - вкажіть текст, який знаходиться між польовим сепаратором і польовим закінченням об'єднання поля - вказати текст, який буде вставлений після об'єднання поля, якщо поле не порожній - вкажіть текст, який буде вставлятися до поля злиття, якщо поле не порожній ``` Докладніше див. інформацію [FieldMergeField](https://reference.aspose.com/words/net/aspose.words.fields/fieldmergefield/) клас APIй ``` Приклад наступного коду показує, як додати `MERGE` використання поля DOM до пункту у документі: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertMergeFieldUsingDOM-InsertMergeFieldUsingDOM.cs" >}} ### Вставки Mail Merge `ADDRESSBLOCK` поле в Документ, використовуючи DOM Про нас `ADDRESSBLOCK` поле використовується для вставки Mail Merge адресний блок у документі Word. `ADDRESSBLOCK` поле в документі Word може бути представлений [FieldAddressBlock](https://reference.aspose.com/words/net/aspose.words.fields/fieldaddressblock/) клас. Ви можете використовувати **FieldAddressBlock** Клас виконання наступних операцій: - вкажіть, чи вкажіть ім'я країни/регіон в полі - вкажіть, чи відформатувати адресу відповідно до країни/регіону одержувача, визначеної POST*CODE (Універсальний поштовий союз 2006) - вкажіть назву виключеної країни/регіону - вказати назву та формат адреси - вказати ідентифікатор мови, який використовується для форматування адреси ``` Докладніше див. інформацію [FieldAddressBlock](https://reference.aspose.com/words/net/aspose.words.fields/fieldaddressblock/) клас APIй ``` Приклад наступного коду показує, як додати Mail Merge `ADDRESSBLOCK` Використання поля DOM до пункту у документі: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertMailMergeAddressBlockFieldUsingDOM-InsertMailMergeAddressBlockFieldUsingDOM.cs" >}} ### Вставки `ADVANCE` JavaScript licenses API Веб-сайт Go1.13.8 Про нас `ADVANCE` поле використовується для відключення наступного тексту в рядок зліва, праворуч, вгору або вниз. Про нас `ADVANCE` поле в документі Word може бути представлений [FieldAdvance](https://reference.aspose.com/words/net/aspose.words.fields/fieldadvance/) клас. Ви можете використовувати **FieldAdvance** Клас виконання наступних операцій: - вказати кількість точок, за допомогою яких текст, який слід перенести поле вертикально з верхнього краю сторінки - вкажіть кількість точок, за допомогою яких текст, який слід перенести поле горизонтально з лівого краю стовпчика, рамки або текстової коробки - вказати кількість точок, за допомогою яких текст, який слід перенести зліва, праворуч, вгору або вниз ``` Докладніше див. інформацію [FieldAdvance](https://reference.aspose.com/words/net/aspose.words.fields/fieldadvance/) клас APIй ``` Приклад наступного коду показує, як додати `ADVANCE` Використання поля DOM до пункту у документі: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertAdvanceFieldWithOutDocumentBuilder-InsertAdvanceFieldWithOutDocumentBuilder.cs" >}} ### Вставки `ASK` JavaScript licenses API Веб-сайт Go1.13.8 Про нас `ASK` поле використовується для підказки користувача для тексту, щоб призначити закладку у документі Word. `ASK` поле в документі Word може бути представлений [FieldAsk](https://reference.aspose.com/words/net/aspose.words.fields/fieldask/) клас. Ви можете використовувати **FieldAsk** Клас виконання наступних операцій: - вказати ім'я закладки - вказати відповідь користувача за замовчуванням (ініційне значення, що міститься в вікні запиту) - вкажіть, чи мається відповідь користувача Mail Merge робота - вказати підказковий текст (голова вікна підказки) ``` Докладніше див. інформацію [FieldAsk](https://reference.aspose.com/words/net/aspose.words.fields/fieldask/) клас APIй ``` Приклад наступного коду показує, як додати `ASK` Використання поля DOM до пункту у документі: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertASKFieldWithOutDocumentBuilder-InsertASKFieldWithOutDocumentBuilder.cs" >}} ### Вставки `AUTHOR` JavaScript licenses API Веб-сайт Go1.13.8 Про нас `AUTHOR` поле використовується для позначення імені автора документа з документа `Document` властивості. Про нас `AUTHOR` поле в документі Word може бути представлений [FieldAuthor](https://reference.aspose.com/words/net/aspose.words.fields/fieldauthor/) клас. Ви можете використовувати **FieldAuthor** Клас виконання наступних операцій: - вказати ім'я автора документа ``` Докладніше див. інформацію [FieldAuthor](https://reference.aspose.com/words/net/aspose.words.fields/fieldauthor/) клас APIй ``` Приклад наступного коду показує, як додати `AUTHOR` Використання поля DOM до пункту у документі: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertAuthorField-InsertAuthorField.cs" >}} ### Вставки `INCLUDETEXT` JavaScript licenses API Веб-сайт Go1.13.8 Про нас `INCLUDETEXT` поле вставляє текст і графіку, що міститься в документі, зазначеному в полі коду. Ви можете вставляти весь документ або частину документа, зазначеного у закладці. Це поле в документі Word представлена INCLUDETEXT. Ви можете використовувати [FieldIncludeText](https://reference.aspose.com/words/net/aspose.words.fields/fieldincludetext/) Клас виконання наступних операцій: - вказати ім'я закладки вказаного документа - вказати розташування документа ``` Докладніше див. інформацію [FieldIncludeText](https://reference.aspose.com/words/net/aspose.words.fields/fieldincludetext/) клас APIй ``` Приклад наступного коду показує, як додати `INCLUDETEXT` використання поля DOM до пункту у документі: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertIncludeFieldWithoutDocumentBuilder-InsertFieldIncludeTextWithoutDocumentBuilder.cs" >}} ### Вставки `TOA` JavaScript licenses API Веб-сайт Go1.13.8 Про нас `TOA` (*Включення повноважень*) польових споруд та вставок таблиці органів влади. Про нас `TOA` поле збирає записи, позначені `TA` (*Увімкнення полів авторських прав*) Microsoft Office Word вставляє `TOA` поле, коли ви натискаєте *Вставити таблицю авторів* в **Зміст** група на **References** Увійти Коли ви переглядаєте `TOA` поле у вашому документі, синтаксис виглядає так: { `TOA` [Switches ] } ``` Докладніше див. інформацію [FieldToa](https://reference.aspose.com/words/net/aspose.words.fields/fieldtoa/) клас APIй ``` Приклад наступного коду показує, як додати `TOA` використання поля DOM до пункту у документі: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-InsertTOAFieldWithoutDocumentBuilder-InsertTOAFieldWithoutDocumentBuilder.cs" >}}