FieldMergingArgs
Inhalt
[
Ausblenden
]FieldMergingArgs class
Liefert Daten für dieMergeField Ereignis.
Um mehr zu erfahren, besuchen Sie dieSerienbriefe und Berichte Dokumentationsartikel.
public class FieldMergingArgs : FieldMergingArgsBase
Eigenschaften
Name | Beschreibung |
---|---|
Document { get; } | Gibt dieDocument Objekt, für das der Serienbrief ausgeführt wird. |
DocumentFieldName { get; } | Ruft den Namen des Seriendruckfelds ab, wie im Dokument angegeben. |
Field { get; } | Ruft das Objekt ab, das das aktuelle Seriendruckfeld darstellt. |
FieldName { get; } | Ruft den Namen des Seriendruckfelds 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 für das aktuelle Seriendruckfeld in das Dokument eingefügt wird. |
Bemerkungen
DerMergeField Das Ereignis tritt während des Seriendrucks auf, wenn im Dokument ein einfaches Feld „mail merge “ gefunden wird. Sie können auf dieses Ereignis reagieren, um „return “-Text für das Seriendruckmodul zurückzugeben und in das Dokument einzufügen.
Beispiele
Zeigt, wie ein Serienbrief mit einem benutzerdefinierten Rückruf ausgeführt wird, der Serienbriefdaten in Form von HTML-Dokumenten verarbeitet.
public void MergeHtml()
{
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 Serienbrief auf ein MERGEFIELD trifft, dessen Name mit dem Präfix "html_" beginnt,
/// Dieser Rückruf analysiert seine Zusammenführungsdaten als HTML-Inhalt und fügt das Ergebnis zum Dokumentspeicherort des MERGEFIELD hinzu.
/// </summary>
private class HandleMergeFieldInsertHtml : IFieldMergingCallback
{
/// <summary>
/// Wird aufgerufen, wenn ein Serienbrief Daten in ein MERGEFIELD zusammenführt.
/// </summary>
void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
{
if (args.DocumentFieldName.StartsWith("html_") && args.Field.GetFieldCode().Contains("\\b"))
{
// Fügen Sie dem Hauptteil des Dokuments analysierte HTML-Daten hinzu.
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
- class FieldMergingArgsBase
- namensraum Aspose.Words.MailMerging
- Montage Aspose.Words