ExecuteWithRegions

ExecuteWithRegions(string, string, DataTable)

Выполняет слияние почты из DataTable в документ с областями слияния почты.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    DataTable dataTable)
ПараметрТипОписание
inputFileNameStringИмя входного файла.
outputFileNameStringИмя выходного файла.
dataTableDataTableИсточник данных для операции слияния почты. Таблица должна иметь установленное свойство TableName.

Примечания

Если выходной формат — изображение (BMP, EMF, EPS, GIF, JPEG, PNG или WebP), каждая страница выходных данных будет сохранена как отдельный файл. Указанное имя выходного файла будет использоваться для генерации имен файлов для каждой части в соответствии с правилом: outputFile_partIndex.extension.

Если выходной формат — TIFF, вывод будет сохранен как один многокадровый файл TIFF.

Примеры

Показывает, как выполнить операцию слияния почты с регионами из DataTable.

// Существует несколько способов выполнить операцию слияния почты с регионами из DataTable:
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 });

Смотрите также


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

Выполняет слияние почты из DataTable в документ с областями слияния почты.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveFormat saveFormat, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ПараметрТипОписание
inputFileNameStringИмя входного файла.
outputFileNameStringИмя выходного файла.
saveFormatSaveFormatФормат сохранения выходных данных.
dataTableDataTableТаблица, содержащая данные для вставки в поля слияния. Имена полей нечувствительны к регистру. Если встречается имя поля, которое не найдено в документе, оно игнорируется.
mailMergeOptionsMailMergeOptionsПараметры слияния почты.

Примечания

Если выходной формат — изображение (BMP, EMF, EPS, GIF, JPEG, PNG или WebP), каждая страница выходных данных будет сохранена как отдельный файл. Указанное имя выходного файла будет использоваться для генерации имен файлов для каждой части в соответствии с правилом: outputFile_partIndex.extension.

Если выходной формат — TIFF, вывод будет сохранен как один многокадровый файл TIFF.

Примеры

Показывает, как выполнить операцию слияния почты с регионами из DataTable.

// Существует несколько способов выполнить операцию слияния почты с регионами из DataTable:
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 });

Смотрите также


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

Выполняет слияние почты из DataTable в документ с областями слияния почты.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveOptions saveOptions, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ПараметрТипОписание
inputFileNameStringИмя входного файла.
outputFileNameStringИмя выходного файла.
saveOptionsSaveOptionsПараметры сохранения выходных данных.
dataTableDataTableТаблица, содержащая данные для вставки в поля слияния. Имена полей нечувствительны к регистру. Если встречается имя поля, которое не найдено в документе, оно игнорируется.
mailMergeOptionsMailMergeOptionsПараметры слияния почты.

Примечания

Если выходной формат — изображение (BMP, EMF, EPS, GIF, JPEG, PNG или WebP), каждая страница выходных данных будет сохранена как отдельный файл. Указанное имя выходного файла будет использоваться для генерации имен файлов для каждой части в соответствии с правилом: outputFile_partIndex.extension.

Если выходной формат — TIFF, вывод будет сохранен как один многокадровый файл TIFF.

Смотрите также


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

Выполняет операцию слияния почты для одной записи.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveFormat saveFormat, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ПараметрТипОписание
inputStreamStreamВходной файловый поток.
outputStreamStreamВыходной файловый поток.
saveFormatSaveFormatФормат сохранения выходных данных.
dataTableDataTableТаблица, содержащая данные для вставки в поля слияния. Имена полей нечувствительны к регистру. Если встречается имя поля, которое не найдено в документе, оно игнорируется.
mailMergeOptionsMailMergeOptionsПараметры слияния почты.

Примечания

Если выходной формат представляет собой изображение (BMP, EMF, EPS, GIF, JPEG, PNG или WebP), в указанном потоке будет сохранена только первая страница вывода.

Если выходной формат — TIFF, вывод будет сохранен как один многокадровый TIFF в указанном потоке.

Примеры

Показывает, как выполнить операцию слияния почты с регионами из DataTable, используя документы из потока.

// Существует несколько способов выполнить операцию слияния почты с регионами из DataTable, используя документы из потока:
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 });
}

Смотрите также


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

Выполняет операцию слияния почты для одной записи.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveOptions saveOptions, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ПараметрТипОписание
inputStreamStreamВходной файловый поток.
outputStreamStreamВыходной файловый поток.
saveOptionsSaveOptionsПараметры сохранения выходных данных.
dataTableDataTableТаблица, содержащая данные для вставки в поля слияния. Имена полей нечувствительны к регистру. Если встречается имя поля, которое не найдено в документе, оно игнорируется.
mailMergeOptionsMailMergeOptionsПараметры слияния почты.

Примечания

Если выходной формат представляет собой изображение (BMP, EMF, EPS, GIF, JPEG, PNG или WebP), в указанном потоке будет сохранена только первая страница вывода.

Если выходной формат — TIFF, вывод будет сохранен как один многокадровый TIFF в указанном потоке.

Смотрите также


ExecuteWithRegions(string, string, DataSet)

Выполняет слияние почты из DataSet в документ с областями слияния почты.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, DataSet dataSet)
ПараметрТипОписание
inputFileNameStringИмя входного файла.
outputFileNameStringИмя выходного файла.
dataSetDataSetDataSet, содержащий данные для вставки в поля слияния почты.

Примечания

Если выходной формат — изображение (BMP, EMF, EPS, GIF, JPEG, PNG или WebP), каждая страница выходных данных будет сохранена как отдельный файл. Указанное имя выходного файла будет использоваться для генерации имен файлов для каждой части в соответствии с правилом: outputFile_partIndex.extension.

Если выходной формат — TIFF, вывод будет сохранен как один многокадровый файл TIFF.

Примеры

Показывает, как выполнить операцию слияния почты с регионами из DataSet.

// Существует несколько способов выполнить операцию слияния почты с регионами из DataSet:
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 });

Смотрите также


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

Выполняет слияние почты из DataSet в документ с областями слияния почты.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveFormat saveFormat, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ПараметрТипОписание
inputFileNameStringИмя входного файла.
outputFileNameStringИмя выходного файла.
saveFormatSaveFormatФормат сохранения выходных данных.
dataSetDataSetDataSet, содержащий данные для вставки в поля слияния почты.
mailMergeOptionsMailMergeOptionsПараметры слияния почты.

Примечания

Если выходной формат — изображение (BMP, EMF, EPS, GIF, JPEG, PNG или WebP), каждая страница выходных данных будет сохранена как отдельный файл. Указанное имя выходного файла будет использоваться для генерации имен файлов для каждой части в соответствии с правилом: outputFile_partIndex.extension.

Если выходной формат — TIFF, вывод будет сохранен как один многокадровый файл TIFF.

Примеры

Показывает, как выполнить операцию слияния почты с регионами из DataSet.

// Существует несколько способов выполнить операцию слияния почты с регионами из DataSet:
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 });

Смотрите также


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

Выполняет слияние почты из DataSet в документ с областями слияния почты.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveOptions saveOptions, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ПараметрТипОписание
inputFileNameStringИмя входного файла.
outputFileNameStringИмя выходного файла.
saveOptionsSaveOptionsПараметры сохранения выходных данных.
dataSetDataSetDataSet, содержащий данные для вставки в поля слияния почты.
mailMergeOptionsMailMergeOptionsПараметры слияния почты.

Примечания

Если выходной формат — изображение (BMP, EMF, EPS, GIF, JPEG, PNG или WebP), каждая страница выходных данных будет сохранена как отдельный файл. Указанное имя выходного файла будет использоваться для генерации имен файлов для каждой части в соответствии с правилом: outputFile_partIndex.extension.

Если выходной формат — TIFF, вывод будет сохранен как один многокадровый файл TIFF.

Смотрите также


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

Выполняет слияние почты из DataSet в документ с областями слияния почты.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveFormat saveFormat, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ПараметрТипОписание
inputStreamStreamВходной файловый поток.
outputStreamStreamВыходной файловый поток.
saveFormatSaveFormatФормат сохранения выходных данных.
dataSetDataSetDataSet, содержащий данные для вставки в поля слияния почты.
mailMergeOptionsMailMergeOptionsПараметры слияния почты.

Примечания

Если выходной формат представляет собой изображение (BMP, EMF, EPS, GIF, JPEG, PNG или WebP), в указанном потоке будет сохранена только первая страница вывода.

Если выходной формат — TIFF, вывод будет сохранен как один многокадровый TIFF в указанном потоке.

Примеры

Показывает, как выполнить операцию слияния почты с регионами из DataSet, используя документы из потока.

// Существует несколько способов выполнить операцию слияния почты с регионами из DataSet, используя документы из потока:
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 });
}

Смотрите также


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

Выполняет слияние почты из DataSet в документ с областями слияния почты.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveOptions saveOptions, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ПараметрТипОписание
inputStreamStreamВходной файловый поток.
outputStreamStreamВыходной файловый поток.
saveOptionsSaveOptionsПараметры сохранения выходных данных.
dataSetDataSetDataSet, содержащий данные для вставки в поля слияния почты.
mailMergeOptionsMailMergeOptionsПараметры слияния почты.

Примечания

Если выходной формат представляет собой изображение (BMP, EMF, EPS, GIF, JPEG, PNG или WebP), в указанном потоке будет сохранена только первая страница вывода.

Если выходной формат — TIFF, вывод будет сохранен как один многокадровый TIFF в указанном потоке.

Смотрите также