FieldMergeField
Содержание
[
Скрывать
]FieldMergeField class
Реализует поле MERGEFIELD.
Чтобы узнать больше, посетитеРабота с полями статья документации.
public class FieldMergeField : Field
Характеристики
| Имя | Описание |
|---|---|
| DisplayResult { get; } | Получает текст, представляющий результат отображаемого поля. |
| End { get; } | Получает узел, представляющий конец поля. |
| FieldName { get; set; } | Получает или задает имя поля данных. |
| FieldNameNoPrefix { get; } | Возвращает только имя поля данных. Любой префикс удаляется из свойства prefix. . |
| Format { get; } | ПолучаетFieldFormat объект, обеспечивающий типизированный доступ к форматированию поля. |
| IsDirty { get; set; } | Получает или устанавливает, является ли текущий результат поля более неправильным (устаревшим) из-за других изменений, внесенных в документ. |
| IsLocked { get; set; } | Получает или задает, заблокировано ли поле (не следует пересчитывать результат). |
| IsMapped { get; set; } | Получает или задает, является ли это поле сопоставленным полем. |
| IsVerticalFormatting { get; set; } | Получает или задает, включить ли преобразование символов для вертикального форматирования. |
| LocaleId { get; set; } | Получает или задает LCID поля. |
| Result { get; set; } | Получает или задает текст, расположенный между разделителем полей и концом поля. |
| Separator { get; } | Получает узел, представляющий разделитель полей. Возможнонулевой . |
| Start { get; } | Получает узел, представляющий начало поля. |
| TextAfter { get; set; } | Получает или задает текст, который будет вставлен после поля, если поле не пустое. |
| TextBefore { get; set; } | Получает или задает текст, который будет вставлен перед полем, если поле не пустое. |
| override Type { get; } | Получает тип поля Microsoft Word. |
Методы
| Имя | Описание |
|---|---|
| GetFieldCode() | Возвращает текст между началом поля и разделителем поля (или концом поля, если разделителя нет). Включены как код поля, так и результат поля дочерних полей. |
| GetFieldCode(bool) | Возвращает текст между началом поля и разделителем полей (или концом поля, если разделителя нет). |
| Remove() | Удаляет поле из документа. Возвращает узел сразу после поля. Если конец поля является последним дочерним его родительского узла, возвращает его родительский абзац. Если поле уже удалено, возвращаетсянулевой . |
| Unlink() | Выполняет отсоединение поля. |
| Update() | Выполняет обновление поля. Выдает, если поле уже обновляется. |
| Update(bool) | Выполняет обновление поля. Выдает, если поле уже обновляется. |
Примечания
Извлекает имя поля данных в символах слияния в основном документе слияния почты. Когда основной документ объединяется с выбранным источником данных, информация из указанного поля данных вставляется вместо поля слияния.
Примеры
Показывает, как использовать поля MERGEFIELD для выполнения слияния почты.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Создайте таблицу данных, которая будет использоваться в качестве источника данных для слияния почты.
DataTable table = new DataTable("Employees");
table.Columns.Add("Courtesy Title");
table.Columns.Add("First Name");
table.Columns.Add("Last Name");
table.Rows.Add("Mr.", "John", "Doe");
table.Rows.Add("Mrs.", "Jane", "Cardholder");
// Вставляем MERGEFIELD со свойством FieldName, равным имени столбца в источнике данных.
FieldMergeField fieldMergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
fieldMergeField.FieldName = "Courtesy Title";
fieldMergeField.IsMapped = true;
fieldMergeField.IsVerticalFormatting = false;
// Мы можем применить текст до и после значения, которое принимает это поле, когда происходит слияние.
fieldMergeField.TextBefore = "Dear ";
fieldMergeField.TextAfter = " ";
Assert.AreEqual(" MERGEFIELD \"Courtesy Title\" \\m \\b \"Dear \" \\f \" \"", fieldMergeField.GetFieldCode());
// Вставляем еще одно MERGEFIELD для другого столбца в источнике данных.
fieldMergeField = (FieldMergeField)builder.InsertField(FieldType.FieldMergeField, true);
fieldMergeField.FieldName = "Last Name";
fieldMergeField.TextAfter = ":";
doc.UpdateFields();
doc.MailMerge.Execute(table);
Assert.AreEqual("Dear Mr. Doe:\u000cDear Mrs. Cardholder:", doc.GetText().Trim());
Смотрите также
- class Field
- пространство имен Aspose.Words.Fields
- сборка Aspose.Words
