--- title: "Обзор полей в C#" --- Aspose.Words библиотека классов, предназначенная для обработки на стороне сервера Microsoft Word документирует и поддерживает поля следующими способами: - Все поля в документе сохраняются во время открытого/сохранения и конверсий - возможно обновление результатов большинства полей В этой статье мы узнаем больше о структуре поля, полях, поддерживаемых в Aspose.Words, Подробности работы с такими полями. ## Полевая структура Поле состоит из: - Узлы запуска поля и разделителя используются для охвата контента, который составляет код поля (обычно в виде простого текста). - Разделитель поля и конец поля охватывают результат поля. Это может быть составлено из различных типов контента, начиная от прогонов текста до абзацев и таблиц. - Некоторые поля могут не иметь разделителя, что означает, что весь контент составляет код поля. - Код поля определяет поведение поля и состоит из идентификатора поля и часто других параметров, таких как имя поля и переключатели. - Результаты на местах содержат самую последнюю оценку на местах. Это значение сохраняется в результате поля и является тем, что отображается пользователю. Некоторые поля могут не иметь какого-либо результата поля, поэтому в документе ничего не будет отображаться. Кроме того, некоторые поля могут не обновляться, поэтому также не будут иметь результата поля. ![fields-aspose-words](/words/net/fields-overview/fields-overview-1.png) Содержимое, которое составляет код поля, хранится как [Run](https://reference.aspose.com/words/net/aspose.words/run/) узлы между ними [FieldStart](https://reference.aspose.com/words/net/aspose.words.fields/fieldstart/) и [FieldSeparator](https://reference.aspose.com/words/net/aspose.words.fields/fieldseparator/). Результат поля хранится между **FieldSeparator** и [FieldEnd](https://reference.aspose.com/words/net/aspose.words.fields/fieldend/) Узлы могут состоять из различных типов контента. Обычно поле содержит только текст, состоящий из **Run** Узлы, однако это возможно для **FieldEnd** Узел должен быть расположен в совершенно другом абзаце и, таким образом, получение результата поля, состоящего из [Логические уровни узлов в документе](/words/ru/net/logical-levels-of-nodes-in-a-document/) такие как **Table** и **Paragraph** Узлы тоже. Вот взгляд на то, как поле хранится в Aspose.Words Используя пример "*Исследователь документов"*, который можно найти на [Github](https://github.com/aspose-words/Aspose.Words-for-.NET/tree/master/Examples/DocsExamples/DocumentExplorer). ![document-explorer-aspose-words](/words/net/fields-overview/fields-overview-2.png) ## Поля в этом Aspose.Words Document Object Model ()DOM) Когда документ загружается в Aspose.Words, Поля документа загружаются в [Aspose.Words Document Object Model (DOM)](/words/ru/net/aspose-words-document-object-model/) как набор отдельных компонентов (узлов). Одно поле загружается как коллекция **FieldStart**, **FieldSeparator** и **FieldEnd** Узлы вместе с содержимым между этими узлами. Если поле не имеет результата поля, то не будет **FieldSeparator** Узел. Все эти узлы всегда находятся в ряде (как дети). [Paragraph](https://reference.aspose.com/words/net/aspose.words/paragraph/) или [SmartTag](https://reference.aspose.com/words/net/aspose.words.markup/smarttag/). В Aspose.Words Каждый из них **FieldXXX** Узлы происходят от [FieldChar](https://reference.aspose.com/words/net/aspose.words.fields/fieldchar/). Этот класс предоставляет свойство проверять тип поля, представленного указанным узлом через [FieldType](https://reference.aspose.com/words/net/aspose.words.fields/fieldtype/) собственность. Например, **FieldType.FieldMergeField** представляет собой поле слияния в документе. ``` В документе Word есть некоторые конкретные поля, которые не импортируются в Aspose.Words как сборник **FieldXXX** Узлы. Например, `LINK` поле и `INCLUDEPICTURE` поле импортируется в Aspose.Words как [Shape](https://reference.aspose.com/words/net/aspose.words.drawing/shape/) объект. Этот объект предоставляет свойства для работы с данными изображения, обычно хранящимися в этих полях. импортировать `INCLUDEPICTURE` поле как **FieldXXX** узлы [PreserveIncludePictureField](https://reference.aspose.com/words/net/aspose.words.loading/loadoptions/preserveincludepicturefield/) опцион должен быть указан как **true**. Поля формы также импортируются в Aspose.Words как свой особый класс. The [FormField](https://reference.aspose.com/words/net/aspose.words.fields/formfield/) Класс представляет собой поле формы в документе Word и предоставляет дополнительные методы, которые являются специфическими для поля формы. ``` ## Поддерживаемые поля Расчет следующих полей поддерживается в текущей версии Aspose.Words: - = (формула) - `ADDRESSBLOCK` - `ASK` - `AUTHOR` - `AUTONUM` - `AUTONUMLGL` - `AUTONUMOUT` - `AUTOTEXT` - `BARCODE` - `COMMENTS` - `COMPARE` - `CREATEDATE` - `DATABASE` - `DATE` - `DISPLAYBARCODE` - `DOCPROPERTY` - `DOCVARIABLE` - `EDITTIME` - `EQ` - `FILENAME` - `FILESIZE` - `FILLIN` - `FORMCHECKBOX` - `FORMDROPDOWN` - `FORMTEXT` - `GLOSSARY` - `GOTOBUTTON` - `GREETINGLINE` - `HYPERLINK` - `IF` - `IMPORT` - `INCLUDE` - `INCLUDEPICTURE` - `INCLUDETEXT` - `INDEX` - `INFO` - `KEYWORDS` - `LASTSAVEDBY` - `LISTNUM` - `MACROBUTTON` - `MERGEBARCODE` - `MERGEFIELD` - `MERGEREC` - `MERGESEQ` - `NEXT` - `NEXTIF` - `NOTEREF` - `NUMCHARS` - `NUMPAGES` - `NUMWORDS` - `PAGE` - `PAGEREF` - `PRINTDATE` - `QUOTE` - `REF` - `REVNUM` - `SAVEDATE` - `SECTION` - `SECTIONPAGES` - `SEQ` - `SET` - `SHAPE` - `SKIPIF` - `STYLEREF` - `SUBJECT` - `SYMBOL` - `TEMPLATE` - `TIME` - `TITLE` - `TOA` - `TOC` - `USERADDRESS` - `USERINITIALS` - `USERNAME` ## Сложный полевой парсинг Aspose.Words Следуйте по пути Microsoft Word обрабатывает поля и в результате правильно обрабатывает: - вложенные поля: `IF { =OR({ COMPARE { =2.5 +PRODUCT(3,5 ,8.4) } > 4}, { =2/2 }) } = 1 "Credit not acceptable" "Credit acceptable"` - полевой аргумент может быть результатом вложенного поля - поля могут быть вложены в код поля, а также в результат поля; - Пространства/нет пространств, цитаты/нет цитат, побег персонажей в полях и т.д `MERGEFIELD \f"Text after""Field \n\ame with \" and \\\ and \\\*"\bTextBefor\e` - поля, которые охватывают несколько абзацев ### Формула поля Aspose.Words обеспечивает очень серьезное выполнение формулы двигателя и поддерживает следующее: - арифметические и логические операторы: `=(54+4*(6-77)-(5))+(-6-5)/4/5` - функции: `=ABS(-01.4)+2.645/(5.6^3.5)+776457 \\\# "#,##0"` - ссылки на закладки: `=IF(C>4, 5,ABS(A)*.76) +3.85` - выключатели форматирования номеров: `=00000000 \\\# "$#,##0.00;($#,##0.00)"` Поддерживаются следующие функции в выражениях: `ABS`, `AND`, `AVERAGE`, `COUNT`, `DEFINED`, `FALSE`, `IF`, `INT`, `MAX`, `MIN`, `MOD`, `NOT`, `OR`, `PRODUCT`, `ROUND`, `SIGN`, `SUM`, TRUE. ### `IF` и `COMPARE` Поля Только некоторые из них `IF` Выражения, которые Aspose.Words Вы можете легко рассчитать, чтобы дать вам представление о том, насколько мощна эта функция: - `IF 3 > 5.7^4+MAX(4,3) True False` - `IF "abcd" > "abc" True False` - `IF "?ab*" = "1abdsg" True False` - `IF 4 = "2*2" True False` - `COMPARE 3+5/34 < 4.6/3/2` ### `DATE` и `TIME` Поля Aspose.Words поддерживает все переключатели форматирования даты и времени, доступные в Microsoft Word, Вот несколько примеров: - `DATE @ "d-MMM-yy"` - `DATE @ "d/MM/yyyy h:mm am/pm` ### Mail Merge Поля Aspose.Words не накладывает никаких ограничений на сложность Mail Merge Поля в ваших документах и поддержка вложенных `IF` поле формулы и может даже вычислить имя поля слияния, используя формулу. Некоторые примеры Mail Merge Поля, которые Aspose.Words поддерживает: - Mail merge переключатели полей: `MERGEFIELD FirstName \\\\\\\\* FirstCap \b "Mr. "` - вложенные поля слияния в формуле: `IF { `Мергефельд` Value1 } >= { `Мергефельд` Value2 } True False` - вычислить название поля слияния во время выполнения: `MERGEFIELD { `если` { `Мергефельд` Value1 } >= { `Мергефельд` Value2 } FirstName"LastName" }` - условный переход к следующей записи в источнике данных: `NEXTIF { `Мергефельд` Value1 } <= { =IF(-2.45 >= 6*{ `Мергефельд` Value2 }, 2, -.45) }` ### Коммутаторы форматов Поле в документе может иметь переключатели форматирования, которые определяют, как следует форматировать полученное значение. Aspose.Words Поддерживает следующие переключатели формата: - \\\@ - форматирование даты и времени - \\\# - форматирование номеров - \\\\ Капс - \\\* FirstCap - \\\* Нижний - \\\ Верхний - \\\* CHARFORMAT - результат форматирования по первому символу полевого кода - MERGEFORMAT - результат форматирования в соответствии с форматированием старого результата ### Date Форматирование чисел в полях Когда Aspose.Words Вычисляет результат поля, ему часто нужно разобрать строку на число или значение даты, а также отформатировать ее обратно в строку. По умолчанию Aspose.Words использует текущую культуру потоков для выполнения анализа и форматирования при расчете значений поля во время обновления поля и mail merge. Существуют также варианты в виде [FieldOptions](https://reference.aspose.com/words/net/aspose.words.fields/fieldoptions/) Класс, который позволяет дополнительно контролировать, какая культура используется во время обновления поля. - по умолчанию [FieldUpdateCultureSource](https://reference.aspose.com/words/net/aspose.words.fields/fieldoptions/fieldupdateculturesource/) имущество устанавливается [CurrentThread](https://reference.aspose.com/words/net/aspose.words.fields/fieldupdateculturesource/) форматирует поля с использованием текущей культуры потоков - Это свойство может быть установлено на [FieldCode](https://reference.aspose.com/words/net/aspose.words.fields/fieldupdateculturesource/) Таким образом, язык, заданный из полевого кода поля, используется для форматирования ### Форматирование с использованием культуры текущего потока Чтобы контролировать культуру, используемую при расчете поля, просто установите **Thread.CurrentThread.CurrentCulture** собственность на культуру по вашему выбору, прежде чем ссылаться на расчет поля. Следующий пример кода показывает, как изменить культуру, используемую в полях форматирования во время обновления: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-ChangeLocale-ChangeLocale.cs" >}} Использование текущей культуры для форматирования полей позволяет системе легко и последовательно контролировать форматирование всех полей в документе во время обновления поля. ### Форматирование с использованием культуры в документе С другой стороны, Microsoft Word Форматирует каждое отдельное поле на основе языка текста, найденного в поле (в частности, выполняется из кода поля). Иногда во время обновления поля это может быть желаемым поведением, например, если у вас есть глобализованные документы, содержащие контент, состоящий из разных языков, и вы хотите, чтобы каждое поле соответствовало используемому в тексте местоположению. Aspose.Words Также поддерживается эта функциональность. The [Document](https://reference.aspose.com/words/net/aspose.words/document/) Класс обеспечивает [FieldOptions](https://reference.aspose.com/words/net/aspose.words/document/fieldoptions/) свойство, содержащее элементы, которые могут быть использованы для контроля обновления полей в документе. Следующий пример кода показывает, как указать, где культура используется для форматирования даты во время обновления поля. Mail Merge Выбирается из: {{< gist "aspose-words-gists" "eacc4fc7407a98d683f3084bb86d58f7" "Examples-CSharp-Programming-Documents-Fields-ChangeFieldUpdateCultureSource-ChangeFieldUpdateCultureSource.cs" >}}