Execute

Execute(string, string, string[], object[])

ينفذ عملية دمج البريد لسجل واحد.

public static void Execute(string inputFileName, string outputFileName, string[] fieldNames, 
    object[] fieldValues)
معامليكتبوصف
inputFileNameStringاسم ملف الإدخال.
outputFileNameStringاسم ملف الإخراج.
fieldNamesString[]مجموعة من أسماء حقول الدمج. أسماء الحقول لا تراعي حالة الأحرف. في حال وجود اسم حقل غير موجود في المستند، فسيتم تجاهله.
fieldValuesObject[]مصفوفة القيم المراد إدراجها في حقول الدمج. يجب أن يكون عدد عناصر هذه المصفوفة مساويًا لعدد عناصر أسماء الحقول.

ملاحظات

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

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

أمثلة

يوضح كيفية إجراء عملية دمج البريد لسجل واحد.

// هناك عدة طرق لإجراء عملية دمج البريد:
string doc = MyDir + "Mail merge.doc";

string[] fieldNames = new string[] { "FirstName", "Location", "SpecialCharsInName()" };
string[] fieldValues = new string[] { "James Bond", "London", "Classified" };

MailMerger.Execute(doc, ArtifactsDir + "LowCode.MailMerge.1.docx", fieldNames, fieldValues);
MailMerger.Execute(doc, ArtifactsDir + "LowCode.MailMerge.2.docx", SaveFormat.Docx, fieldNames, fieldValues);
MailMergeOptions mailMergeOptions = new MailMergeOptions();
mailMergeOptions.TrimWhitespaces = true;
MailMerger.Execute(doc, ArtifactsDir + "LowCode.MailMerge.3.docx", SaveFormat.Docx, fieldNames, fieldValues, mailMergeOptions);

أنظر أيضا


Execute(string, string, SaveFormat, string[], object[], MailMergeOptions)

ينفذ عملية دمج البريد لسجل واحد.

public static void Execute(string inputFileName, string outputFileName, SaveFormat saveFormat, 
    string[] fieldNames, object[] fieldValues, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputFileNameStringاسم ملف الإدخال.
outputFileNameStringاسم ملف الإخراج.
saveFormatSaveFormatتنسيق حفظ الإخراج.
fieldNamesString[]مجموعة من أسماء حقول الدمج. أسماء الحقول لا تراعي حالة الأحرف. في حال وجود اسم حقل غير موجود في المستند، فسيتم تجاهله.
fieldValuesObject[]مصفوفة القيم المراد إدراجها في حقول الدمج. يجب أن يكون عدد عناصر هذه المصفوفة مساويًا لعدد عناصر أسماء الحقول.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

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

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

أمثلة

يوضح كيفية إجراء عملية دمج البريد لسجل واحد.

// هناك عدة طرق لإجراء عملية دمج البريد:
string doc = MyDir + "Mail merge.doc";

string[] fieldNames = new string[] { "FirstName", "Location", "SpecialCharsInName()" };
string[] fieldValues = new string[] { "James Bond", "London", "Classified" };

MailMerger.Execute(doc, ArtifactsDir + "LowCode.MailMerge.1.docx", fieldNames, fieldValues);
MailMerger.Execute(doc, ArtifactsDir + "LowCode.MailMerge.2.docx", SaveFormat.Docx, fieldNames, fieldValues);
MailMergeOptions mailMergeOptions = new MailMergeOptions();
mailMergeOptions.TrimWhitespaces = true;
MailMerger.Execute(doc, ArtifactsDir + "LowCode.MailMerge.3.docx", SaveFormat.Docx, fieldNames, fieldValues, mailMergeOptions);

أنظر أيضا


Execute(string, string, SaveOptions, string[], object[], MailMergeOptions)

ينفذ عملية دمج البريد لسجل واحد.

public static void Execute(string inputFileName, string outputFileName, SaveOptions saveOptions, 
    string[] fieldNames, object[] fieldValues, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputFileNameStringاسم ملف الإدخال.
outputFileNameStringاسم ملف الإخراج.
saveOptionsSaveOptionsخيارات حفظ الإخراج.
fieldNamesString[]مجموعة من أسماء حقول الدمج. أسماء الحقول لا تراعي حالة الأحرف. في حال وجود اسم حقل غير موجود في المستند، فسيتم تجاهله.
fieldValuesObject[]مصفوفة القيم المراد إدراجها في حقول الدمج. يجب أن يكون عدد عناصر هذه المصفوفة مساويًا لعدد عناصر أسماء الحقول.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

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

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

أنظر أيضا


Execute(Stream, Stream, SaveFormat, string[], object[], MailMergeOptions)

ينفذ عملية دمج البريد لسجل واحد.

public static void Execute(Stream inputStream, Stream outputStream, SaveFormat saveFormat, 
    string[] fieldNames, object[] fieldValues, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputStreamStreamتدفق ملف الإدخال.
outputStreamStreamدفق ملف الإخراج.
saveFormatSaveFormatتنسيق حفظ الإخراج.
fieldNamesString[]مجموعة من أسماء حقول الدمج. أسماء الحقول لا تراعي حالة الأحرف. في حال وجود اسم حقل غير موجود في المستند، فسيتم تجاهله.
fieldValuesObject[]مصفوفة القيم المراد إدراجها في حقول الدمج. يجب أن يكون عدد عناصر هذه المصفوفة مساويًا لعدد عناصر أسماء الحقول.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

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

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

أمثلة

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

// هناك عدة طرق لإجراء عملية دمج البريد باستخدام المستندات من التدفق:
string[] fieldNames = new string[] { "FirstName", "Location", "SpecialCharsInName()" };
string[] fieldValues = new string[] { "James Bond", "London", "Classified" };

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

    using (FileStream streamOut = new FileStream(ArtifactsDir + "LowCode.MailMergeStream.2.docx", FileMode.Create, FileAccess.ReadWrite))
    {
        MailMergeOptions mailMergeOptions = new MailMergeOptions();
        mailMergeOptions.TrimWhitespaces = true;
        MailMerger.Execute(streamIn, streamOut, SaveFormat.Docx, fieldNames, fieldValues, mailMergeOptions);
    }
}

أنظر أيضا


Execute(Stream, Stream, SaveOptions, string[], object[], MailMergeOptions)

ينفذ عملية دمج البريد لسجل واحد.

public static void Execute(Stream inputStream, Stream outputStream, SaveOptions saveOptions, 
    string[] fieldNames, object[] fieldValues, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputStreamStreamتدفق ملف الإدخال.
outputStreamStreamدفق ملف الإخراج.
saveOptionsSaveOptionsخيارات حفظ الإخراج.
fieldNamesString[]مجموعة من أسماء حقول الدمج. أسماء الحقول لا تراعي حالة الأحرف. في حال وجود اسم حقل غير موجود في المستند، فسيتم تجاهله.
fieldValuesObject[]مصفوفة القيم المراد إدراجها في حقول الدمج. يجب أن يكون عدد عناصر هذه المصفوفة مساويًا لعدد عناصر أسماء الحقول.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

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

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

أنظر أيضا


Execute(string, string, DataRow)

يقوم بدمج البريد من صف بيانات إلى المستند.

public static void Execute(string inputFileName, string outputFileName, DataRow dataRow)
معامليكتبوصف
inputFileNameStringاسم ملف الإدخال.
outputFileNameStringاسم ملف الإخراج.
dataRowDataRowصف يحتوي على بيانات لإدراجها في حقول دمج البريد. أسماء الحقول لا تراعي حالة الأحرف. في حال وجود اسم حقل غير موجود في المستند، فسيتم تجاهله.

ملاحظات

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

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

أمثلة

يوضح كيفية إجراء عملية دمج البريد من DataRow.

// هناك عدة طرق لإجراء عملية دمج البريد من DataRow:
string doc = MyDir + "Mail merge.doc";

DataTable dataTable = new DataTable();
dataTable.Columns.Add("FirstName");
dataTable.Columns.Add("Location");
dataTable.Columns.Add("SpecialCharsInName()");

DataRow dataRow = dataTable.Rows.Add(new string[] { "James Bond", "London", "Classified" });

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

أنظر أيضا


Execute(string, string, SaveFormat, DataRow, MailMergeOptions)

يقوم بدمج البريد من صف بيانات إلى المستند.

public static void Execute(string inputFileName, string outputFileName, SaveFormat saveFormat, 
    DataRow dataRow, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputFileNameStringاسم ملف الإدخال.
outputFileNameStringاسم ملف الإخراج.
saveFormatSaveFormatتنسيق حفظ الإخراج.
dataRowDataRowصف يحتوي على بيانات لإدراجها في حقول دمج البريد. أسماء الحقول لا تراعي حالة الأحرف. في حال وجود اسم حقل غير موجود في المستند، فسيتم تجاهله.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

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

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

أمثلة

يوضح كيفية إجراء عملية دمج البريد من DataRow.

// هناك عدة طرق لإجراء عملية دمج البريد من DataRow:
string doc = MyDir + "Mail merge.doc";

DataTable dataTable = new DataTable();
dataTable.Columns.Add("FirstName");
dataTable.Columns.Add("Location");
dataTable.Columns.Add("SpecialCharsInName()");

DataRow dataRow = dataTable.Rows.Add(new string[] { "James Bond", "London", "Classified" });

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

أنظر أيضا


Execute(string, string, SaveOptions, DataRow, MailMergeOptions)

يقوم بدمج البريد من صف بيانات إلى المستند.

public static void Execute(string inputFileName, string outputFileName, SaveOptions saveOptions, 
    DataRow dataRow, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputFileNameStringاسم ملف الإدخال.
outputFileNameStringاسم ملف الإخراج.
saveOptionsSaveOptionsخيارات حفظ الإخراج.
dataRowDataRowصف يحتوي على بيانات لإدراجها في حقول دمج البريد. أسماء الحقول لا تراعي حالة الأحرف. في حال وجود اسم حقل غير موجود في المستند، فسيتم تجاهله.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

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

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

أنظر أيضا


Execute(Stream, Stream, SaveFormat, DataRow, MailMergeOptions)

ينفذ عملية دمج البريد لسجل واحد.

public static void Execute(Stream inputStream, Stream outputStream, SaveFormat saveFormat, 
    DataRow dataRow, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputStreamStreamتدفق ملف الإدخال.
outputStreamStreamدفق ملف الإخراج.
saveFormatSaveFormatتنسيق حفظ الإخراج.
dataRowDataRowصف يحتوي على بيانات لإدراجها في حقول دمج البريد. أسماء الحقول لا تراعي حالة الأحرف. في حال وجود اسم حقل غير موجود في المستند، فسيتم تجاهله.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

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

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

أمثلة

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

// هناك عدة طرق لإجراء عملية دمج البريد من DataRow باستخدام المستندات من التدفق:
DataTable dataTable = new DataTable();
dataTable.Columns.Add("FirstName");
dataTable.Columns.Add("Location");
dataTable.Columns.Add("SpecialCharsInName()");

DataRow dataRow = dataTable.Rows.Add(new string[] { "James Bond", "London", "Classified" });

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

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

أنظر أيضا


Execute(Stream, Stream, SaveOptions, DataRow, MailMergeOptions)

ينفذ عملية دمج البريد لسجل واحد.

public static void Execute(Stream inputStream, Stream outputStream, SaveOptions saveOptions, 
    DataRow dataRow, MailMergeOptions mailMergeOptions = null)
معامليكتبوصف
inputStreamStreamتدفق ملف الإدخال.
outputStreamStreamدفق ملف الإخراج.
saveOptionsSaveOptionsخيارات حفظ الإخراج.
dataRowDataRowصف يحتوي على بيانات لإدراجها في حقول دمج البريد. أسماء الحقول لا تراعي حالة الأحرف. في حال وجود اسم حقل غير موجود في المستند، فسيتم تجاهله.
mailMergeOptionsMailMergeOptionsخيارات دمج البريد.

ملاحظات

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

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

أنظر أيضا


Execute(string, string, DataTable)

يقوم بدمج البريد من جدول بيانات إلى المستند.

public static void Execute(string inputFileName, string outputFileName, DataTable dataTable)
معامليكتبوصف
inputFileNameStringاسم ملف الإدخال.
outputFileNameStringاسم ملف الإخراج.
dataTableDataTableجدول يحتوي على بيانات لإدراجها في حقول دمج البريد. أسماء الحقول لا تراعي حالة الأحرف. في حال وجود اسم حقل غير موجود في المستند، فسيتم تجاهله.

ملاحظات

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

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

أمثلة

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

// هناك عدة طرق لإجراء عملية دمج البريد من جدول البيانات:
string doc = MyDir + "Mail merge.doc";

DataTable dataTable = new DataTable();
dataTable.Columns.Add("FirstName");
dataTable.Columns.Add("Location");
dataTable.Columns.Add("SpecialCharsInName()");

DataRow dataRow = dataTable.Rows.Add(new string[] { "James Bond", "London", "Classified" });

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

أنظر أيضا


Execute(string, string, SaveFormat, DataTable, MailMergeOptions)

يقوم بدمج البريد من صف بيانات إلى المستند.

public static void Execute(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.doc";

DataTable dataTable = new DataTable();
dataTable.Columns.Add("FirstName");
dataTable.Columns.Add("Location");
dataTable.Columns.Add("SpecialCharsInName()");

DataRow dataRow = dataTable.Rows.Add(new string[] { "James Bond", "London", "Classified" });

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

أنظر أيضا


Execute(string, string, SaveOptions, DataTable, MailMergeOptions)

يقوم بدمج البريد من صف بيانات إلى المستند.

public static void Execute(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 متعدد الإطارات.

أنظر أيضا


Execute(Stream, Stream, SaveFormat, DataTable, MailMergeOptions)

ينفذ عملية دمج البريد لسجل واحد.

public static void Execute(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();
dataTable.Columns.Add("FirstName");
dataTable.Columns.Add("Location");
dataTable.Columns.Add("SpecialCharsInName()");

DataRow dataRow = dataTable.Rows.Add(new string[] { "James Bond", "London", "Classified" });

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

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

أنظر أيضا


Execute(Stream, Stream, SaveOptions, DataTable, MailMergeOptions)

ينفذ عملية دمج البريد لسجل واحد.

public static void Execute(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 متعدد الإطارات إلى الدفق المحدد.

أنظر أيضا