MailMergeOptions

MailMergeOptions class

يمثل خيارات لوظيفة دمج البريد.

public class MailMergeOptions

المنشئون

اسموصف
MailMergeOptions()Default_Constructor

الخصائص

اسموصف
CleanupOptions { get; set; }يحصل على مجموعة من العلامات التي تحدد العناصر التي يجب إزالتها أثناء دمج البريد أو يعينها.
CleanupParagraphsWithPunctuationMarks { get; set; }يحصل على قيمة أو يعينها تشير إلى ما إذا كانت الفقرات التي تحتوي على علامات ترقيم تعتبر فارغة ويجب إزالتها إذاRemoveEmptyParagraphs تم تحديد الخيار.
MergeDuplicateRegions { get; set; }يحصل على قيمة أو يعينها تشير إلى ما إذا كان يجب دمج جميع مناطق دمج البريد للمستندات التي تحمل اسم مصدر البيانات أثناء تنفيذ دمج البريد مع المناطق مقابل مصدر البيانات أو المنطقة الأولى فقط.
MergeWholeDocument { get; set; }يحصل على قيمة أو يعينها للإشارة إلى ما إذا كانت الحقول في المستند بأكمله يتم تحديثها أثناء تنفيذ دمج البريد مع المناطق.
PreserveUnusedTags { get; set; }يحصل على قيمة تشير إلى ما إذا كان يجب الحفاظ على علامات “الشارب” غير المستخدمة أو تعيينها.
RegionEndTag { get; set; }يحصل على علامة نهاية منطقة دمج البريد أو يعينها.
RegionStartTag { get; set; }يحصل على علامة بدء منطقة دمج البريد أو يعينها.
RestartListsAtEachSection { get; set; }يحصل على قيمة أو يعينها للإشارة إلى ما إذا كان سيتم إعادة تشغيل القوائم في كل قسم بعد تنفيذ دمج البريد.
RetainFirstSectionStart { get; set; }يحصل على قيمة أو يعينها تشير إلى ما إذا كان يتم الاحتفاظ ببداية قسم المستند الأول ونسخه لصفوف مصدر البيانات اللاحقة أثناء دمج البريد أو تحديثها وفقًا لسلوك MS Word.
TrimWhitespaces { get; set; }يحصل على قيمة أو يعينها للإشارة إلى ما إذا كانت المسافات البيضاء النهائية والبادئة يتم اقتصاصها من قيم دمج البريد.
UnconditionalMergeFieldsAndRegions { get; set; }يحصل على قيمة أو يعينها تشير إلى ما إذا كانت حقول الدمج ومناطق الدمج مدمجة بغض النظر عن حالة حقل IF الرئيسي.
UseNonMergeFields { get; set; }عندماحقيقي , يحدد أنه بالإضافة إلى حقول MERGEFIELD، يتم تنفيذ دمج البريد في بعض الأنواع الأخرى من الحقول و أيضًا في علامات “{{fieldName}}”.
UseWholeParagraphAsRegion { get; set; }يحصل على قيمة أو يعينها للإشارة إلى ما إذا كانت الفقرة بأكملها تحتوي علىبدء تشغيل الجدول أونهاية الجدول field أو نطاق معين بينبدء تشغيل الجدول ونهاية الجدول يجب تضمين الحقول في منطقة دمج البريد.

أمثلة

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

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

أنظر أيضا