FieldMergingArgs

FieldMergingArgs class

Liefert Daten für die MergeField Ereignis.

public class FieldMergingArgs : FieldMergingArgsBase

Eigenschaften

Name Beschreibung
Document { get; } Gibt die zurückDocument Objekt, für das der Seriendruck durchgeführt wird.
DocumentFieldName { get; } Ruft den Namen des Briefvorlagenfelds ab, wie im Dokument angegeben.
Field { get; } Ruft das Objekt ab, das das aktuelle Briefvorlagenfeld darstellt.
FieldName { get; } Ruft den Namen des Briefvorlagenfelds in der Datenquelle ab.
FieldValue { get; set; } Ruft den Wert des Felds aus der Datenquelle ab oder legt ihn fest.
RecordIndex { get; } Ruft den nullbasierten Index des Datensatzes ab, der zusammengeführt wird.
TableName { get; } Ruft den Namen der Datentabelle für den aktuellen Zusammenführungsvorgang oder eine leere Zeichenfolge ab, wenn der Name nicht verfügbar ist.
Text { get; set; } Ruft den Text ab oder legt ihn fest, der in das Dokument für das aktuelle Briefvorlagenfeld eingefügt wird.

Bemerkungen

Das MergeField Das Ereignis tritt während des Seriendrucks auf, wenn ein einfaches mail merge -Feld im Dokument gefunden wird. Sie können auf dieses Ereignis reagieren, um Text zurückzugeben, den die Seriendruck-Engine in das Dokument einfügen soll.

Beispiele

Zeigt, wie Sie einen Seriendruck mit einem benutzerdefinierten Rückruf ausführen, der Zusammenführungsdaten in Form von HTML-Dokumenten verarbeitet.

{
    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>
/// Wenn der Seriendruck auf ein MERGEFIELD trifft, dessen Name mit dem Präfix "html_" beginnt,
/// Dieser Callback parst seine Zusammenführungsdaten als HTML-Inhalt und fügt das Ergebnis dem Dokumentspeicherort von MERGEFIELD hinzu.
/// </summary>
private class HandleMergeFieldInsertHtml : IFieldMergingCallback
{
    /// <summary>
    /// Wird aufgerufen, wenn bei einem Seriendruck Daten in einem MERGEFIELD zusammengeführt werden.
    /// </summary>
    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        if (args.DocumentFieldName.StartsWith("html_") && args.Field.GetFieldCode().Contains("\\b"))
        {
            // Geparste HTML-Daten zum Hauptteil des Dokuments hinzufügen.
            DocumentBuilder builder = new DocumentBuilder(args.Document);
            builder.MoveToMergeField(args.DocumentFieldName);
            builder.InsertHtml((string)args.FieldValue);

            // Da wir den zusammengeführten Inhalt bereits manuell eingefügt haben,
             // Wir müssen auf dieses Ereignis nicht reagieren, indem wir Inhalte über die Eigenschaft "Text" zurückgeben.
            args.Text = string.Empty;
        }
    }

    void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
    {
        // Nichts tun.
    }
}

Siehe auch

FieldMergingArgsBase