ExecuteWithRegions

ExecuteWithRegions(string, string, 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 متعدد الإطارات.

أمثلة

يوضح كيفية القيام بعملية دمج البريد مع المناطق من جدول البيانات.

// هناك عدة طرق لإجراء عملية دمج البريد مع المناطق من جدول البيانات:
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)

يقوم بإجراء دمج البريد من جدول بيانات إلى المستند الذي يحتوي على مناطق دمج البريد.

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 متعدد الإطارات.

أمثلة

يوضح كيفية القيام بعملية دمج البريد مع المناطق من جدول البيانات.

// هناك عدة طرق لإجراء عملية دمج البريد مع المناطق من جدول البيانات:
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)

يقوم بإجراء دمج البريد من جدول بيانات إلى المستند الذي يحتوي على مناطق دمج البريد.

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 = 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)

يقوم بتنفيذ دمج البريد من مجموعة بيانات إلى مستند يحتوي على مناطق دمج البريد.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, DataSet dataSet)
معامليكتبوصف
inputFileNameStringاسم ملف الإدخال.
outputFileNameStringاسم ملف الإخراج.
dataSetDataSetمجموعة البيانات التي تحتوي على البيانات التي سيتم إدراجها في حقول دمج البريد.

ملاحظات

إذا كان تنسيق الإخراج صورة (BMP، EMF، EPS، GIF، JPEG، PNG، أو WebP)، فسيتم حفظ كل صفحة من الإخراج كملف منفصل. سيتم استخدام اسم ملف الإخراج المحدد لإنشاء أسماء ملفات لكل جزء وفقًا للقاعدة: outputFile_partIndex.extension.

إذا كان تنسيق الإخراج هو TIFF، فسيتم حفظ الإخراج كملف TIFF متعدد الإطارات.

أمثلة

يوضح كيفية القيام بعملية دمج البريد باستخدام المناطق من مجموعة البيانات.

// هناك عدة طرق لإجراء عملية دمج البريد مع المناطق من مجموعة البيانات:
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)

يقوم بتنفيذ دمج البريد من مجموعة بيانات إلى المستند الذي يحتوي على مناطق دمج البريد.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveFormat saveFormat, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputFileNameStringاسم ملف الإدخال.
outputFileNameStringاسم ملف الإخراج.
saveFormatSaveFormatتنسيق حفظ الإخراج.
dataSetDataSetمجموعة البيانات التي تحتوي على البيانات التي سيتم إدراجها في حقول دمج البريد.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

إذا كان تنسيق الإخراج صورة (BMP، EMF، EPS، GIF، JPEG، PNG، أو WebP)، فسيتم حفظ كل صفحة من الإخراج كملف منفصل. سيتم استخدام اسم ملف الإخراج المحدد لإنشاء أسماء ملفات لكل جزء وفقًا للقاعدة: outputFile_partIndex.extension.

إذا كان تنسيق الإخراج هو TIFF، فسيتم حفظ الإخراج كملف TIFF متعدد الإطارات.

أمثلة

يوضح كيفية القيام بعملية دمج البريد باستخدام المناطق من مجموعة البيانات.

// هناك عدة طرق لإجراء عملية دمج البريد مع المناطق من مجموعة البيانات:
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)

يقوم بتنفيذ دمج البريد من مجموعة بيانات إلى المستند الذي يحتوي على مناطق دمج البريد.

public static void ExecuteWithRegions(string inputFileName, string outputFileName, 
    SaveOptions saveOptions, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputFileNameStringاسم ملف الإدخال.
outputFileNameStringاسم ملف الإخراج.
saveOptionsSaveOptionsخيارات حفظ الإخراج.
dataSetDataSetمجموعة البيانات التي تحتوي على البيانات التي سيتم إدراجها في حقول دمج البريد.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

إذا كان تنسيق الإخراج صورة (BMP، EMF، EPS، GIF، JPEG، PNG، أو WebP)، فسيتم حفظ كل صفحة من الإخراج كملف منفصل. سيتم استخدام اسم ملف الإخراج المحدد لإنشاء أسماء ملفات لكل جزء وفقًا للقاعدة: outputFile_partIndex.extension.

إذا كان تنسيق الإخراج هو TIFF، فسيتم حفظ الإخراج كملف TIFF متعدد الإطارات.

أنظر أيضا


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

يقوم بتنفيذ دمج البريد من مجموعة بيانات إلى المستند الذي يحتوي على مناطق دمج البريد.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveFormat saveFormat, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputStreamStreamتدفق ملف الإدخال.
outputStreamStreamدفق ملف الإخراج.
saveFormatSaveFormatتنسيق حفظ الإخراج.
dataSetDataSetمجموعة البيانات التي تحتوي على البيانات التي سيتم إدراجها في حقول دمج البريد.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

إذا كان تنسيق الإخراج عبارة عن صورة (BMP، أو EMF، أو EPS، أو GIF، أو JPEG، أو PNG، أو WebP)، فسيتم حفظ الصفحة الأولى فقط من الإخراج في التدفق المحدد.

إذا كان تنسيق الإخراج هو TIFF، فسيتم حفظ الإخراج كملف TIFF متعدد الإطارات إلى الدفق المحدد.

أمثلة

يوضح كيفية القيام بعملية دمج البريد مع المناطق من مجموعة بيانات باستخدام المستندات من التدفق.

// هناك عدة طرق لإجراء عملية دمج البريد مع المناطق من مجموعة بيانات باستخدام المستندات من التدفق:
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)

يقوم بتنفيذ دمج البريد من مجموعة بيانات إلى المستند الذي يحتوي على مناطق دمج البريد.

public static void ExecuteWithRegions(Stream inputStream, Stream outputStream, 
    SaveOptions saveOptions, DataSet dataSet, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputStreamStreamتدفق ملف الإدخال.
outputStreamStreamدفق ملف الإخراج.
saveOptionsSaveOptionsخيارات حفظ الإخراج.
dataSetDataSetمجموعة البيانات التي تحتوي على البيانات التي سيتم إدراجها في حقول دمج البريد.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

إذا كان تنسيق الإخراج عبارة عن صورة (BMP، أو EMF، أو EPS، أو GIF، أو JPEG، أو PNG، أو WebP)، فسيتم حفظ الصفحة الأولى فقط من الإخراج في التدفق المحدد.

إذا كان تنسيق الإخراج هو TIFF، فسيتم حفظ الإخراج كملف TIFF متعدد الإطارات إلى الدفق المحدد.

أنظر أيضا