ExecuteWithRegions

ExecuteWithRegions(string, string, DataTable)

Führt einen Seriendruck aus einer DataTable in das Dokument mit Seriendruckbereichen durch.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    DataTable dataTable)
ParameterTypBeschreibung
inputFileNameStringDer Name der Eingabedatei.
outputFileNameStringDer Name der Ausgabedatei.
dataTableDataTableDatenquelle für den Seriendruckvorgang. Die TableName-Eigenschaft der Tabelle muss festgelegt sein.

Bemerkungen

Wenn das Ausgabeformat ein Bild (BMP, EMF, EPS, GIF, JPEG, PNG oder WebP) ist, wird jede Seite der Ausgabe als separate Datei gespeichert. Der angegebene Ausgabedateiname wird verwendet, um Dateinamen für jedes Teil nach der Regel „outputFile_partIndex.extension“ zu generieren.

Wenn das Ausgabeformat TIFF ist, wird die Ausgabe als einzelne TIFF-Datei mit mehreren Frames gespeichert.

Beispiele

Zeigt, wie Sie aus einer DataTable einen Serienbrief mit Regionen-Operation erstellen.

// Es gibt mehrere Möglichkeiten, Serienbriefe mit Regionen aus einer DataTable heraus zu erstellen:
string doc = MyDir + "Mail merge with regions.docx";

DataTable dataTable = new DataTable("MyTable");
dataTable.Columns.Add("FirstName");
dataTable.Columns.Add("LastName");
dataTable.Rows.Add(new object[] { "John", "Doe" });
dataTable.Rows.Add(new object[] { "", "" });
dataTable.Rows.Add(new object[] { "Jane", "Doe" });

MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataTable.1.docx", dataTable);
MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataTable.2.docx", SaveFormat.Docx, dataTable);
MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataTable.3.docx", SaveFormat.Docx, dataTable, new MailMergeOptions() { TrimWhitespaces = true });

Siehe auch


ExecuteWithRegions(string, string, SaveFormat, DataTable, MailMergeOptions)

Führt einen Seriendruck aus einer DataTable in das Dokument mit Seriendruckbereichen durch.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveFormat saveFormat, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ParameterTypBeschreibung
inputFileNameStringDer Name der Eingabedatei.
outputFileNameStringDer Name der Ausgabedatei.
saveFormatSaveFormatDas Speicherformat der Ausgabe.
dataTableDataTableTabelle mit Daten, die in Seriendruckfelder eingefügt werden sollen. Bei Feldnamen wird die Groß- und Kleinschreibung nicht berücksichtigt. Ein im Dokument nicht gefundener Feldname wird ignoriert.
mailMergeOptionsMailMergeOptionsOptionen für Serienbriefe.

Bemerkungen

Wenn das Ausgabeformat ein Bild (BMP, EMF, EPS, GIF, JPEG, PNG oder WebP) ist, wird jede Seite der Ausgabe als separate Datei gespeichert. Der angegebene Ausgabedateiname wird verwendet, um Dateinamen für jedes Teil nach der Regel „outputFile_partIndex.extension“ zu generieren.

Wenn das Ausgabeformat TIFF ist, wird die Ausgabe als einzelne TIFF-Datei mit mehreren Frames gespeichert.

Beispiele

Zeigt, wie Sie aus einer DataTable einen Serienbrief mit Regionen-Operation erstellen.

// Es gibt mehrere Möglichkeiten, Serienbriefe mit Regionen aus einer DataTable heraus zu erstellen:
string doc = MyDir + "Mail merge with regions.docx";

DataTable dataTable = new DataTable("MyTable");
dataTable.Columns.Add("FirstName");
dataTable.Columns.Add("LastName");
dataTable.Rows.Add(new object[] { "John", "Doe" });
dataTable.Rows.Add(new object[] { "", "" });
dataTable.Rows.Add(new object[] { "Jane", "Doe" });

MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataTable.1.docx", dataTable);
MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataTable.2.docx", SaveFormat.Docx, dataTable);
MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataTable.3.docx", SaveFormat.Docx, dataTable, new MailMergeOptions() { TrimWhitespaces = true });

Siehe auch


ExecuteWithRegions(string, string, SaveOptions, DataTable, MailMergeOptions)

Führt einen Seriendruck aus einer DataTable in das Dokument mit Seriendruckbereichen durch.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveOptions saveOptions, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ParameterTypBeschreibung
inputFileNameStringDer Name der Eingabedatei.
outputFileNameStringDer Name der Ausgabedatei.
saveOptionsSaveOptionsDie Speicheroptionen der Ausgabe.
dataTableDataTableTabelle mit Daten, die in Seriendruckfelder eingefügt werden sollen. Bei Feldnamen wird die Groß- und Kleinschreibung nicht berücksichtigt. Ein im Dokument nicht gefundener Feldname wird ignoriert.
mailMergeOptionsMailMergeOptionsOptionen für Serienbriefe.

Bemerkungen

Wenn das Ausgabeformat ein Bild (BMP, EMF, EPS, GIF, JPEG, PNG oder WebP) ist, wird jede Seite der Ausgabe als separate Datei gespeichert. Der angegebene Ausgabedateiname wird verwendet, um Dateinamen für jedes Teil nach der Regel „outputFile_partIndex.extension“ zu generieren.

Wenn das Ausgabeformat TIFF ist, wird die Ausgabe als einzelne TIFF-Datei mit mehreren Frames gespeichert.

Siehe auch


ExecuteWithRegions(Stream, Stream, SaveFormat, DataTable, MailMergeOptions)

Führt einen Serienbriefvorgang für einen einzelnen Datensatz aus.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveFormat saveFormat, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ParameterTypBeschreibung
inputStreamStreamDer Eingabedateistream.
outputStreamStreamDer Ausgabedateistream.
saveFormatSaveFormatDas Speicherformat der Ausgabe.
dataTableDataTableTabelle mit Daten, die in Seriendruckfelder eingefügt werden sollen. Bei Feldnamen wird die Groß- und Kleinschreibung nicht berücksichtigt. Ein im Dokument nicht gefundener Feldname wird ignoriert.
mailMergeOptionsMailMergeOptionsOptionen für Serienbriefe.

Bemerkungen

Wenn das Ausgabeformat ein Bild ist (BMP, EMF, EPS, GIF, JPEG, PNG oder WebP), wird nur die erste Seite der Ausgabe im angegebenen Stream gespeichert.

Wenn das Ausgabeformat TIFF ist, wird die Ausgabe als einzelnes TIFF mit mehreren Frames im angegebenen Stream gespeichert.

Beispiele

Zeigt, wie Sie mithilfe von Dokumenten aus dem Stream einen Serienbrief mit Regionen-Vorgang aus einer DataTable heraus durchführen.

// Es gibt mehrere Möglichkeiten, Serienbriefe mit Regionen aus einer DataTable unter Verwendung von Dokumenten aus dem Stream auszuführen:
DataTable dataTable = new DataTable("MyTable");
dataTable.Columns.Add("FirstName");
dataTable.Columns.Add("LastName");
dataTable.Rows.Add(new object[] { "John", "Doe" });
dataTable.Rows.Add(new object[] { "", "" });
dataTable.Rows.Add(new object[] { "Jane", "Doe" });

using (FileStream streamIn = new FileStream(MyDir + "Mail merge.doc", FileMode.Open, FileAccess.Read))
{
    using (FileStream streamOut = new FileStream(ArtifactsDir + "LowCode.MailMergeStreamWithRegionsDataTable.1.docx", FileMode.Create, FileAccess.ReadWrite))
        MailMerger.ExecuteWithRegions(streamIn, streamOut, SaveFormat.Docx, dataTable);

    using (FileStream streamOut = new FileStream(ArtifactsDir + "LowCode.MailMergeStreamWithRegionsDataTable.2.docx", FileMode.Create, FileAccess.ReadWrite))
        MailMerger.ExecuteWithRegions(streamIn, streamOut, SaveFormat.Docx, dataTable, new MailMergeOptions() { TrimWhitespaces = true });
}

Siehe auch


ExecuteWithRegions(Stream, Stream, SaveOptions, DataTable, MailMergeOptions)

Führt einen Serienbriefvorgang für einen einzelnen Datensatz aus.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveOptions saveOptions, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ParameterTypBeschreibung
inputStreamStreamDer Eingabedateistream.
outputStreamStreamDer Ausgabedateistream.
saveOptionsSaveOptionsDie Speicheroptionen der Ausgabe.
dataTableDataTableTabelle mit Daten, die in Seriendruckfelder eingefügt werden sollen. Bei Feldnamen wird die Groß- und Kleinschreibung nicht berücksichtigt. Ein im Dokument nicht gefundener Feldname wird ignoriert.
mailMergeOptionsMailMergeOptionsOptionen für Serienbriefe.

Bemerkungen

Wenn das Ausgabeformat ein Bild ist (BMP, EMF, EPS, GIF, JPEG, PNG oder WebP), wird nur die erste Seite der Ausgabe im angegebenen Stream gespeichert.

Wenn das Ausgabeformat TIFF ist, wird die Ausgabe als einzelnes TIFF mit mehreren Frames im angegebenen Stream gespeichert.

Siehe auch


ExecuteWithRegions(string, string, DataSet)

Führt einen Serienbrief aus einem DataSet in ein Dokument mit Serienbriefbereichen aus.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, DataSet dataSet)
ParameterTypBeschreibung
inputFileNameStringDer Name der Eingabedatei.
outputFileNameStringDer Name der Ausgabedatei.
dataSetDataSetDataSet, das Daten enthält, die in Serienbrieffelder eingefügt werden sollen.

Bemerkungen

Wenn das Ausgabeformat ein Bild (BMP, EMF, EPS, GIF, JPEG, PNG oder WebP) ist, wird jede Seite der Ausgabe als separate Datei gespeichert. Der angegebene Ausgabedateiname wird verwendet, um Dateinamen für jedes Teil nach der Regel „outputFile_partIndex.extension“ zu generieren.

Wenn das Ausgabeformat TIFF ist, wird die Ausgabe als einzelne TIFF-Datei mit mehreren Frames gespeichert.

Beispiele

Zeigt, wie Sie aus einem DataSet einen Serienbrief mit Regionen-Operation durchführen.

// Es gibt mehrere Möglichkeiten, Serienbriefe mit Regionen aus einem DataSet heraus durchzuführen:
string doc = MyDir + "Mail merge with regions data set.docx";

DataTable tableCustomers = new DataTable("Customers");
tableCustomers.Columns.Add("CustomerID");
tableCustomers.Columns.Add("CustomerName");
tableCustomers.Rows.Add(new object[] { 1, "John Doe" });
tableCustomers.Rows.Add(new object[] { 2, "Jane Doe" });

DataTable tableOrders = new DataTable("Orders");
tableOrders.Columns.Add("CustomerID");
tableOrders.Columns.Add("ItemName");
tableOrders.Columns.Add("Quantity");
tableOrders.Rows.Add(new object[] { 1, "Hawaiian", 2 });
tableOrders.Rows.Add(new object[] { 2, "Pepperoni", 1 });
tableOrders.Rows.Add(new object[] { 2, "Chicago", 1 });

DataSet dataSet = new DataSet();
dataSet.Tables.Add(tableCustomers);
dataSet.Tables.Add(tableOrders);
dataSet.Relations.Add(tableCustomers.Columns["CustomerID"], tableOrders.Columns["CustomerID"]);

MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataSet.1.docx", dataSet);
MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataSet.2.docx", SaveFormat.Docx, dataSet);
MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataSet.3.docx", SaveFormat.Docx, dataSet, new MailMergeOptions() { TrimWhitespaces = true });

Siehe auch


ExecuteWithRegions(string, string, SaveFormat, DataSet, MailMergeOptions)

Führt einen Seriendruck aus einem DataSet in das Dokument mit Seriendruckbereichen aus.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveFormat saveFormat, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ParameterTypBeschreibung
inputFileNameStringDer Name der Eingabedatei.
outputFileNameStringDer Name der Ausgabedatei.
saveFormatSaveFormatDas Speicherformat der Ausgabe.
dataSetDataSetDataSet, das Daten enthält, die in Serienbrieffelder eingefügt werden sollen.
mailMergeOptionsMailMergeOptionsOptionen für Serienbriefe.

Bemerkungen

Wenn das Ausgabeformat ein Bild (BMP, EMF, EPS, GIF, JPEG, PNG oder WebP) ist, wird jede Seite der Ausgabe als separate Datei gespeichert. Der angegebene Ausgabedateiname wird verwendet, um Dateinamen für jedes Teil nach der Regel „outputFile_partIndex.extension“ zu generieren.

Wenn das Ausgabeformat TIFF ist, wird die Ausgabe als einzelne TIFF-Datei mit mehreren Frames gespeichert.

Beispiele

Zeigt, wie Sie aus einem DataSet einen Serienbrief mit Regionen-Operation durchführen.

// Es gibt mehrere Möglichkeiten, Serienbriefe mit Regionen aus einem DataSet heraus durchzuführen:
string doc = MyDir + "Mail merge with regions data set.docx";

DataTable tableCustomers = new DataTable("Customers");
tableCustomers.Columns.Add("CustomerID");
tableCustomers.Columns.Add("CustomerName");
tableCustomers.Rows.Add(new object[] { 1, "John Doe" });
tableCustomers.Rows.Add(new object[] { 2, "Jane Doe" });

DataTable tableOrders = new DataTable("Orders");
tableOrders.Columns.Add("CustomerID");
tableOrders.Columns.Add("ItemName");
tableOrders.Columns.Add("Quantity");
tableOrders.Rows.Add(new object[] { 1, "Hawaiian", 2 });
tableOrders.Rows.Add(new object[] { 2, "Pepperoni", 1 });
tableOrders.Rows.Add(new object[] { 2, "Chicago", 1 });

DataSet dataSet = new DataSet();
dataSet.Tables.Add(tableCustomers);
dataSet.Tables.Add(tableOrders);
dataSet.Relations.Add(tableCustomers.Columns["CustomerID"], tableOrders.Columns["CustomerID"]);

MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataSet.1.docx", dataSet);
MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataSet.2.docx", SaveFormat.Docx, dataSet);
MailMerger.ExecuteWithRegions(doc, ArtifactsDir + "LowCode.MailMergeWithRegionsDataSet.3.docx", SaveFormat.Docx, dataSet, new MailMergeOptions() { TrimWhitespaces = true });

Siehe auch


ExecuteWithRegions(string, string, SaveOptions, DataSet, MailMergeOptions)

Führt einen Seriendruck aus einem DataSet in das Dokument mit Seriendruckbereichen aus.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveOptions saveOptions, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ParameterTypBeschreibung
inputFileNameStringDer Name der Eingabedatei.
outputFileNameStringDer Name der Ausgabedatei.
saveOptionsSaveOptionsDie Speicheroptionen der Ausgabe.
dataSetDataSetDataSet, das Daten enthält, die in Serienbrieffelder eingefügt werden sollen.
mailMergeOptionsMailMergeOptionsOptionen für Serienbriefe.

Bemerkungen

Wenn das Ausgabeformat ein Bild (BMP, EMF, EPS, GIF, JPEG, PNG oder WebP) ist, wird jede Seite der Ausgabe als separate Datei gespeichert. Der angegebene Ausgabedateiname wird verwendet, um Dateinamen für jedes Teil nach der Regel „outputFile_partIndex.extension“ zu generieren.

Wenn das Ausgabeformat TIFF ist, wird die Ausgabe als einzelne TIFF-Datei mit mehreren Frames gespeichert.

Siehe auch


ExecuteWithRegions(Stream, Stream, SaveFormat, DataSet, MailMergeOptions)

Führt einen Seriendruck aus einem DataSet in das Dokument mit Seriendruckbereichen aus.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveFormat saveFormat, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ParameterTypBeschreibung
inputStreamStreamDer Eingabedateistream.
outputStreamStreamDer Ausgabedateistream.
saveFormatSaveFormatDas Speicherformat der Ausgabe.
dataSetDataSetDataSet, das Daten enthält, die in Serienbrieffelder eingefügt werden sollen.
mailMergeOptionsMailMergeOptionsOptionen für Serienbriefe.

Bemerkungen

Wenn das Ausgabeformat ein Bild ist (BMP, EMF, EPS, GIF, JPEG, PNG oder WebP), wird nur die erste Seite der Ausgabe im angegebenen Stream gespeichert.

Wenn das Ausgabeformat TIFF ist, wird die Ausgabe als einzelnes TIFF mit mehreren Frames im angegebenen Stream gespeichert.

Beispiele

Zeigt, wie Sie mithilfe von Dokumenten aus dem Stream einen Serienbrief mit Regionen-Operation aus einem DataSet heraus durchführen.

// Es gibt mehrere Möglichkeiten, Serienbriefe mit Regionen aus einem DataSet unter Verwendung von Dokumenten aus dem Stream auszuführen:
DataTable tableCustomers = new DataTable("Customers");
tableCustomers.Columns.Add("CustomerID");
tableCustomers.Columns.Add("CustomerName");
tableCustomers.Rows.Add(new object[] { 1, "John Doe" });
tableCustomers.Rows.Add(new object[] { 2, "Jane Doe" });

DataTable tableOrders = new DataTable("Orders");
tableOrders.Columns.Add("CustomerID");
tableOrders.Columns.Add("ItemName");
tableOrders.Columns.Add("Quantity");
tableOrders.Rows.Add(new object[] { 1, "Hawaiian", 2 });
tableOrders.Rows.Add(new object[] { 2, "Pepperoni", 1 });
tableOrders.Rows.Add(new object[] { 2, "Chicago", 1 });

DataSet dataSet = new DataSet();
dataSet.Tables.Add(tableCustomers);
dataSet.Tables.Add(tableOrders);
dataSet.Relations.Add(tableCustomers.Columns["CustomerID"], tableOrders.Columns["CustomerID"]);

using (FileStream streamIn = new FileStream(MyDir + "Mail merge.doc", FileMode.Open, FileAccess.Read))
{
    using (FileStream streamOut = new FileStream(ArtifactsDir + "LowCode.MailMergeStreamWithRegionsDataTable.1.docx", FileMode.Create, FileAccess.ReadWrite))
        MailMerger.ExecuteWithRegions(streamIn, streamOut, SaveFormat.Docx, dataSet);

    using (FileStream streamOut = new FileStream(ArtifactsDir + "LowCode.MailMergeStreamWithRegionsDataTable.2.docx", FileMode.Create, FileAccess.ReadWrite))
        MailMerger.ExecuteWithRegions(streamIn, streamOut, SaveFormat.Docx, dataSet, new MailMergeOptions() { TrimWhitespaces = true });
}

Siehe auch


ExecuteWithRegions(Stream, Stream, SaveOptions, DataSet, MailMergeOptions)

Führt einen Seriendruck aus einem DataSet in das Dokument mit Seriendruckbereichen aus.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveOptions saveOptions, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ParameterTypBeschreibung
inputStreamStreamDer Eingabedateistream.
outputStreamStreamDer Ausgabedateistream.
saveOptionsSaveOptionsDie Speicheroptionen der Ausgabe.
dataSetDataSetDataSet, das Daten enthält, die in Serienbrieffelder eingefügt werden sollen.
mailMergeOptionsMailMergeOptionsOptionen für Serienbriefe.

Bemerkungen

Wenn das Ausgabeformat ein Bild ist (BMP, EMF, EPS, GIF, JPEG, PNG oder WebP), wird nur die erste Seite der Ausgabe im angegebenen Stream gespeichert.

Wenn das Ausgabeformat TIFF ist, wird die Ausgabe als einzelnes TIFF mit mehreren Frames im angegebenen Stream gespeichert.

Siehe auch