ExecuteWithRegions

ExecuteWithRegions(string, string, DataTable)

Esegue la stampa unione da una tabella dati nel documento con aree di stampa unione.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    DataTable dataTable)
ParametroTipoDescrizione
inputFileNameStringNome del file di input.
outputFileNameStringNome del file di output.
dataTableDataTableOrigine dati per l’operazione di stampa unione. La tabella deve avere la proprietà TableName impostata.

Osservazioni

Se il formato di output è un’immagine (BMP, EMF, EPS, GIF, JPEG, PNG o WebP), ogni pagina dell’output verrà salvata come file separato. Il nome del file di output specificato verrà utilizzato per generare i nomi file per ogni parte, seguendo la regola: outputFile_partIndex.extension.

Se il formato di output è TIFF, l’output verrà salvato come un singolo file TIFF multi-frame.

Esempi

Mostra come eseguire un’operazione di stampa unione con regioni da una tabella dati.

// Esistono diversi modi per eseguire un'operazione di stampa unione con regioni da una 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 });

Guarda anche


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

Esegue la stampa unione da una tabella dati nel documento con aree di stampa unione.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveFormat saveFormat, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ParametroTipoDescrizione
inputFileNameStringNome del file di input.
outputFileNameStringNome del file di output.
saveFormatSaveFormatFormato di salvataggio dell’output.
dataTableDataTableTabella contenente i dati da inserire nei campi di stampa unione. I nomi dei campi non fanno distinzione tra maiuscole e minuscole. Se viene rilevato un nome di campo non presente nel documento, viene ignorato.
mailMergeOptionsMailMergeOptionsOpzioni di unione posta.

Osservazioni

Se il formato di output è un’immagine (BMP, EMF, EPS, GIF, JPEG, PNG o WebP), ogni pagina dell’output verrà salvata come file separato. Il nome del file di output specificato verrà utilizzato per generare i nomi file per ogni parte, seguendo la regola: outputFile_partIndex.extension.

Se il formato di output è TIFF, l’output verrà salvato come un singolo file TIFF multi-frame.

Esempi

Mostra come eseguire un’operazione di stampa unione con regioni da una tabella dati.

// Esistono diversi modi per eseguire un'operazione di stampa unione con regioni da una 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 });

Guarda anche


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

Esegue la stampa unione da una tabella dati nel documento con aree di stampa unione.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveOptions saveOptions, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ParametroTipoDescrizione
inputFileNameStringNome del file di input.
outputFileNameStringNome del file di output.
saveOptionsSaveOptionsOpzioni di salvataggio dell’output.
dataTableDataTableTabella contenente i dati da inserire nei campi di stampa unione. I nomi dei campi non fanno distinzione tra maiuscole e minuscole. Se viene rilevato un nome di campo non presente nel documento, viene ignorato.
mailMergeOptionsMailMergeOptionsOpzioni di unione posta.

Osservazioni

Se il formato di output è un’immagine (BMP, EMF, EPS, GIF, JPEG, PNG o WebP), ogni pagina dell’output verrà salvata come file separato. Il nome del file di output specificato verrà utilizzato per generare i nomi file per ogni parte, seguendo la regola: outputFile_partIndex.extension.

Se il formato di output è TIFF, l’output verrà salvato come un singolo file TIFF multi-frame.

Guarda anche


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

Esegue un’operazione di unione di posta per un singolo record.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveFormat saveFormat, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ParametroTipoDescrizione
inputStreamStreamFlusso del file di input.
outputStreamStreamFlusso del file di output.
saveFormatSaveFormatFormato di salvataggio dell’output.
dataTableDataTableTabella contenente i dati da inserire nei campi di stampa unione. I nomi dei campi non fanno distinzione tra maiuscole e minuscole. Se viene rilevato un nome di campo non presente nel documento, viene ignorato.
mailMergeOptionsMailMergeOptionsOpzioni di unione posta.

Osservazioni

Se il formato di output è un’immagine (BMP, EMF, EPS, GIF, JPEG, PNG o WebP), solo la prima pagina dell’output verrà salvata nel flusso specificato.

Se il formato di output è TIFF, l’output verrà salvato come un singolo TIFF multi-frame nel flusso specificato.

Esempi

Mostra come eseguire un’operazione di unione di stampe con regioni da una tabella dati utilizzando i documenti del flusso.

// Esistono diversi modi per eseguire un'operazione di unione di posta con regioni da una DataTable utilizzando i documenti dal flusso:
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 });
}

Guarda anche


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

Esegue un’operazione di unione di posta per un singolo record.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveOptions saveOptions, DataTable dataTable, MailMergeOptions mailMergeOptions = null)
ParametroTipoDescrizione
inputStreamStreamFlusso del file di input.
outputStreamStreamFlusso del file di output.
saveOptionsSaveOptionsOpzioni di salvataggio dell’output.
dataTableDataTableTabella contenente i dati da inserire nei campi di stampa unione. I nomi dei campi non fanno distinzione tra maiuscole e minuscole. Se viene rilevato un nome di campo non presente nel documento, viene ignorato.
mailMergeOptionsMailMergeOptionsOpzioni di unione posta.

Osservazioni

Se il formato di output è un’immagine (BMP, EMF, EPS, GIF, JPEG, PNG o WebP), solo la prima pagina dell’output verrà salvata nel flusso specificato.

Se il formato di output è TIFF, l’output verrà salvato come un singolo TIFF multi-frame nel flusso specificato.

Guarda anche


ExecuteWithRegions(string, string, DataSet)

Esegue la stampa unione da un DataSet in un documento con aree di stampa unione.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, DataSet dataSet)
ParametroTipoDescrizione
inputFileNameStringNome del file di input.
outputFileNameStringNome del file di output.
dataSetDataSetDataSet contenente i dati da inserire nei campi di stampa unione.

Osservazioni

Se il formato di output è un’immagine (BMP, EMF, EPS, GIF, JPEG, PNG o WebP), ogni pagina dell’output verrà salvata come file separato. Il nome del file di output specificato verrà utilizzato per generare i nomi file per ogni parte, seguendo la regola: outputFile_partIndex.extension.

Se il formato di output è TIFF, l’output verrà salvato come un singolo file TIFF multi-frame.

Esempi

Mostra come eseguire un’operazione di stampa unione con regioni da un DataSet.

// Esistono diversi modi per eseguire un'operazione di unione di posta con regioni da un 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 });

Guarda anche


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

Esegue la stampa unione da un DataSet nel documento con aree di stampa unione.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveFormat saveFormat, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ParametroTipoDescrizione
inputFileNameStringNome del file di input.
outputFileNameStringNome del file di output.
saveFormatSaveFormatFormato di salvataggio dell’output.
dataSetDataSetDataSet contenente i dati da inserire nei campi di stampa unione.
mailMergeOptionsMailMergeOptionsOpzioni di unione posta.

Osservazioni

Se il formato di output è un’immagine (BMP, EMF, EPS, GIF, JPEG, PNG o WebP), ogni pagina dell’output verrà salvata come file separato. Il nome del file di output specificato verrà utilizzato per generare i nomi file per ogni parte, seguendo la regola: outputFile_partIndex.extension.

Se il formato di output è TIFF, l’output verrà salvato come un singolo file TIFF multi-frame.

Esempi

Mostra come eseguire un’operazione di stampa unione con regioni da un DataSet.

// Esistono diversi modi per eseguire un'operazione di unione di posta con regioni da un 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 });

Guarda anche


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

Esegue la stampa unione da un DataSet nel documento con aree di stampa unione.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveOptions saveOptions, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ParametroTipoDescrizione
inputFileNameStringNome del file di input.
outputFileNameStringNome del file di output.
saveOptionsSaveOptionsOpzioni di salvataggio dell’output.
dataSetDataSetDataSet contenente i dati da inserire nei campi di stampa unione.
mailMergeOptionsMailMergeOptionsOpzioni di unione posta.

Osservazioni

Se il formato di output è un’immagine (BMP, EMF, EPS, GIF, JPEG, PNG o WebP), ogni pagina dell’output verrà salvata come file separato. Il nome del file di output specificato verrà utilizzato per generare i nomi file per ogni parte, seguendo la regola: outputFile_partIndex.extension.

Se il formato di output è TIFF, l’output verrà salvato come un singolo file TIFF multi-frame.

Guarda anche


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

Esegue la stampa unione da un DataSet nel documento con aree di stampa unione.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveFormat saveFormat, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ParametroTipoDescrizione
inputStreamStreamFlusso del file di input.
outputStreamStreamFlusso del file di output.
saveFormatSaveFormatFormato di salvataggio dell’output.
dataSetDataSetDataSet contenente i dati da inserire nei campi di stampa unione.
mailMergeOptionsMailMergeOptionsOpzioni di unione posta.

Osservazioni

Se il formato di output è un’immagine (BMP, EMF, EPS, GIF, JPEG, PNG o WebP), solo la prima pagina dell’output verrà salvata nel flusso specificato.

Se il formato di output è TIFF, l’output verrà salvato come un singolo TIFF multi-frame nel flusso specificato.

Esempi

Mostra come eseguire un’operazione di unione di stampe con regioni da un DataSet utilizzando i documenti del flusso.

// Esistono diversi modi per eseguire un'operazione di unione di posta con regioni da un DataSet utilizzando i documenti dal flusso:
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 });
}

Guarda anche


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

Esegue la stampa unione da un DataSet nel documento con aree di stampa unione.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveOptions saveOptions, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
ParametroTipoDescrizione
inputStreamStreamFlusso del file di input.
outputStreamStreamFlusso del file di output.
saveOptionsSaveOptionsOpzioni di salvataggio dell’output.
dataSetDataSetDataSet contenente i dati da inserire nei campi di stampa unione.
mailMergeOptionsMailMergeOptionsOpzioni di unione posta.

Osservazioni

Se il formato di output è un’immagine (BMP, EMF, EPS, GIF, JPEG, PNG o WebP), solo la prima pagina dell’output verrà salvata nel flusso specificato.

Se il formato di output è TIFF, l’output verrà salvato come un singolo TIFF multi-frame nel flusso specificato.

Guarda anche