FieldNext
Содержание
[
Скрывать
]FieldNext class
Реализует поле NEXT.
Чтобы узнать больше, посетитеРабота с полями статья документации.
public class FieldNext : Field
Конструкторы
Имя | Описание |
---|---|
FieldNext() | Конструктор по умолчанию. |
Характеристики
Имя | Описание |
---|---|
DisplayResult { get; } | Получает текст, представляющий результат отображаемого поля. |
End { get; } | Получает узел, представляющий конец поля. |
Format { get; } | ПолучаетFieldFormat объект, обеспечивающий типизированный доступ к форматированию поля. |
IsDirty { get; set; } | Получает или устанавливает, является ли текущий результат поля более неправильным (устаревшим) из-за других изменений, внесенных в документ. |
IsLocked { get; set; } | Получает или задает, заблокировано ли поле (не следует пересчитывать результат). |
LocaleId { get; set; } | Получает или задает LCID поля. |
Result { get; set; } | Получает или задает текст, расположенный между разделителем полей и концом поля. |
Separator { get; } | Получает узел, представляющий разделитель полей. Возможнонулевой . |
Start { get; } | Получает узел, представляющий начало поля. |
virtual Type { get; } | Получает тип поля Microsoft Word. |
Методы
Имя | Описание |
---|---|
GetFieldCode() | Возвращает текст между началом поля и разделителем поля (или концом поля, если разделителя нет). Включены как код поля, так и результат поля дочерних полей. |
GetFieldCode(bool) | Возвращает текст между началом поля и разделителем полей (или концом поля, если разделителя нет). |
Remove() | Удаляет поле из документа. Возвращает узел сразу после поля. Если конец поля является последним дочерним его родительского узла, возвращает его родительский абзац. Если поле уже удалено, возвращаетсянулевой . |
Unlink() | Выполняет отсоединение поля. |
Update() | Выполняет обновление поля. Выдает, если поле уже обновляется. |
Update(bool) | Выполняет обновление поля. Выдает, если поле уже обновляется. |
Примечания
Объединяет следующую запись данных в текущий результирующий объединенный документ вместо запуска нового объединенного документа a .
Примеры
Показывает, как использовать поля NEXT/NEXTIF для объединения нескольких строк на одну страницу во время слияния почты.
public void FieldNext()
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Создадим источник данных для нашего слияния почты с 3 строками.
// Слияние почты, использующее эту таблицу, обычно создает трехстраничный документ.
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");
table.Rows.Add("Mr.", "Joe", "Bloggs");
InsertMergeFields(builder, "First row: ");
// Если у нас есть несколько полей слияния с одинаковым именем поля,
// они получат данные из одной и той же строки источника данных и отобразят одно и то же значение после слияния.
// Поле NEXT сообщает слиянию писем о необходимости немедленного перемещения на одну строку вниз,
// это означает, что любые поля MERGEFIELD, следующие за полем NEXT, получат данные из следующей строки.
// Никогда не пытайтесь перейти к следующей строке, пока вы уже находитесь в последней строке.
FieldNext fieldNext = (FieldNext)builder.InsertField(FieldType.FieldNext, true);
Assert.AreEqual(" NEXT ", fieldNext.GetFieldCode());
// После слияния значения источника данных, которые принимают эти MERGEFIELD
// окажется на той же странице, что и поля MERGEFIELD выше.
InsertMergeFields(builder, "Second row: ");
// Поле NEXTIF имеет ту же функцию, что и поле NEXT,
// но он переходит к следующей строке, только если утверждение, созданное с помощью следующих трех свойств, истинно.
FieldNextIf fieldNextIf = (FieldNextIf)builder.InsertField(FieldType.FieldNextIf, true);
fieldNextIf.LeftExpression = "5";
fieldNextIf.RightExpression = "2 + 3";
fieldNextIf.ComparisonOperator = "=";
Assert.AreEqual(" NEXTIF 5 = \"2 + 3\"", fieldNextIf.GetFieldCode());
// Если сравнение, указанное в поле выше, верно,
// следующие три поля слияния будут брать данные из третьей строки.
// В противном случае эти поля снова возьмут данные из строки 2.
InsertMergeFields(builder, "Third row: ");
doc.MailMerge.Execute(table);
// В нашем источнике данных 3 строки, и мы дважды пропустили строки.
// Наш выходной документ будет иметь 1 страницу с данными из всех 3 строк.
doc.Save(ArtifactsDir + "Field.NEXT.NEXTIF.docx");
}
/// <summary>
/// Использует построитель документов для вставки полей MERGEFIELD для источника данных, который содержит столбцы с именами «Вежливое название», «Имя» и «Фамилия».
/// </summary>
public void InsertMergeFields(DocumentBuilder builder, string firstFieldTextBefore)
{
InsertMergeField(builder, "Courtesy Title", firstFieldTextBefore, " ");
InsertMergeField(builder, "First Name", null, " ");
InsertMergeField(builder, "Last Name", null, null);
builder.InsertParagraph();
}
/// <summary>
/// Использует построитель документов для вставки MERRGEFIELD с указанными свойствами.
/// </summary>
public void InsertMergeField(DocumentBuilder builder, string fieldName, string textBefore, string textAfter)
{
FieldMergeField field = (FieldMergeField) builder.InsertField(FieldType.FieldMergeField, true);
field.FieldName = fieldName;
field.TextBefore = textBefore;
field.TextAfter = textAfter;
}
Смотрите также
- class Field
- пространство имен Aspose.Words.Fields
- сборка Aspose.Words