Class FieldMergingArgs
Содержание
[
Скрывать
]FieldMergingArgs class
Предоставляет данные для MergeField событие.
public class FieldMergingArgs : FieldMergingArgsBase
Характеристики
Имя | Описание |
---|---|
Document { get; } | ВозвращаетDocument объект, для которого выполняется слияние. |
DocumentFieldName { get; } | Получает имя поля слияния, как указано в документе. |
Field { get; } | Получает объект, представляющий текущее поле слияния. |
FieldName { get; } | Получает имя поля слияния в источнике данных. |
FieldValue { get; set; } | Получает или задает значение поля из источника данных. |
RecordIndex { get; } | Получает нулевой индекс объединяемой записи. |
TableName { get; } | Получает имя таблицы данных для текущей операции слияния или пустую строку, если имя недоступно. |
Text { get; set; } | Получает или задает текст, который будет вставлен в документ для текущего поля слияния. |
Примечания
MergeField событие возникает во время слияния почты, когда в документе встречается простое поле слияния почты . Вы можете ответить на это событие, отправив текст return для механизма слияния, который будет вставлен в документ.
Примеры
Показывает, как выполнить слияние почты с помощью пользовательского обратного вызова, который обрабатывает данные слияния в виде HTML-документов.
{
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertField(@"MERGEFIELD html_Title \b Content");
builder.InsertField(@"MERGEFIELD html_Body \b Content");
object[] mergeData =
{
"<html>" +
"<h1>" +
"<span style=\"color: #0000ff; font-family: Arial;\">Hello World!</span>" +
"</h1>" +
"</html>",
"<html>" +
"<blockquote>" +
"<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.</p>" +
"</blockquote>" +
"</html>"
};
doc.MailMerge.FieldMergingCallback = new HandleMergeFieldInsertHtml();
doc.MailMerge.Execute(new[] { "html_Title", "html_Body" }, mergeData);
doc.Save(ArtifactsDir + "MailMergeEvent.MergeHtml.docx");
}
/// <summary>
/// Если слияние почты встречает MERGEFIELD, имя которого начинается с префикса "html_",
/// этот обратный вызов анализирует свои данные слияния как содержимое HTML и добавляет результат в расположение документа MERGEFIELD.
/// </summary>
private class HandleMergeFieldInsertHtml : IFieldMergingCallback
{
/// <summary>
/// Вызывается, когда слияние почты объединяет данные в MERGEFIELD.
/// </summary>
void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
{
if (args.DocumentFieldName.StartsWith("html_") && args.Field.GetFieldCode().Contains("\\b"))
{
// Добавляем проанализированные HTML-данные в тело документа.
DocumentBuilder builder = new DocumentBuilder(args.Document);
builder.MoveToMergeField(args.DocumentFieldName);
builder.InsertHtml((string)args.FieldValue);
// Так как мы уже вставили объединенный контент вручную,
// нам не нужно будет реагировать на это событие, возвращая содержимое через свойство «Текст».
args.Text = string.Empty;
}
}
void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
{
// Ничего не делать.
}
}
Смотрите также
- class FieldMergingArgsBase
- пространство имен Aspose.Words.MailMerging
- сборка Aspose.Words