Class MailMergeOptions
Namespace: Aspose.Words.LowCode
Assembly: Aspose.Words.dll
يمثل خيارات وظيفة دمج البريد.
public class MailMergeOptions
الوراثة
الأعضاء الموروثة
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
المنشئات
MailMergeOptions()
public MailMergeOptions()
الخصائص
CleanupOptions
يحصل أو يحدد مجموعة من العلامات التي تحدد العناصر التي يجب إزالتها أثناء دمج البريد.
public MailMergeCleanupOptions CleanupOptions { get; set; }
قيمة الخاصية
CleanupParagraphsWithPunctuationMarks
يحصل أو يحدد قيمة تشير إلى ما إذا كانت الفقرات التي تحتوي على علامات ترقيم تعتبر فارغة ويجب إزالتها إذا تم تحديد خيار Aspose.Words.MailMerging.MailMergeCleanupOptions.RemoveEmptyParagraphs.
public bool CleanupParagraphsWithPunctuationMarks { get; set; }
قيمة الخاصية
ملاحظات
القيمة الافتراضية هي true
.
MergeDuplicateRegions
يحصل أو يحدد قيمة تشير إلى ما إذا كانت جميع مناطق دمج البريد في الوثيقة التي تحمل اسم مصدر البيانات يجب دمجها أثناء تنفيذ دمج البريد مع المناطق ضد مصدر البيانات أو فقط الأولى.
public bool MergeDuplicateRegions { get; set; }
قيمة الخاصية
ملاحظات
القيمة الافتراضية هي false
.
MergeWholeDocument
يحصل أو يحدد قيمة تشير إلى ما إذا كانت الحقول في الوثيقة بأكملها يتم تحديثها أثناء تنفيذ دمج البريد مع المناطق.
public bool MergeWholeDocument { get; set; }
قيمة الخاصية
ملاحظات
القيمة الافتراضية هي false
.
PreserveUnusedTags
يحصل أو يحدد قيمة تشير إلى ما إذا كانت العلامات “المستعملة” يجب أن تُحفظ.
public bool PreserveUnusedTags { get; set; }
قيمة الخاصية
ملاحظات
القيمة الافتراضية هي false
.
انظر أيضًا
MailMergeOptions.UseNonMergeFields
RegionEndTag
يحصل أو يحدد علامة نهاية منطقة دمج البريد.
public string RegionEndTag { get; set; }
قيمة الخاصية
RegionStartTag
يحصل أو يحدد علامة بداية منطقة دمج البريد.
public string RegionStartTag { get; set; }
قيمة الخاصية
RestartListsAtEachSection
يحصل أو يحدد قيمة تشير إلى ما إذا كانت القوائم تُعاد بدءها في كل قسم بعد تنفيذ دمج البريد.
public bool RestartListsAtEachSection { get; set; }
قيمة الخاصية
ملاحظات
القيمة الافتراضية هي true
.
RetainFirstSectionStart
يحصل أو يحدد قيمة تشير إلى ما إذا كانت بداية القسم من القسم الأول في الوثيقة ونسخها لصفوف مصدر البيانات التالية تُحتفظ بها أثناء دمج البريد أو يتم تحديثها وفقًا لسلوك MS Word.
public bool RetainFirstSectionStart { get; set; }
قيمة الخاصية
ملاحظات
القيمة الافتراضية هي true
.
TrimWhitespaces
يحصل أو يحدد قيمة تشير إلى ما إذا كانت المسافات الفارغة المتبقية والمقدمة تُقص من قيم دمج البريد.
public bool TrimWhitespaces { get; set; }
قيمة الخاصية
ملاحظات
القيمة الافتراضية هي true
.
UnconditionalMergeFieldsAndRegions
يحصل أو يحدد قيمة تشير إلى ما إذا كانت حقول الدمج ومناطق الدمج تُدمج بغض النظر عن شرط حقل IF الأب.
public bool UnconditionalMergeFieldsAndRegions { get; set; }
قيمة الخاصية
ملاحظات
القيمة الافتراضية هي false
.
UseNonMergeFields
عندما تكون true
، تحدد أنه بالإضافة إلى حقول MERGEFIELD، يتم تنفيذ دمج البريد في بعض الأنواع الأخرى من الحقول وأيضًا في علامات “{{fieldName}}”.
public bool UseNonMergeFields { get; set; }
قيمة الخاصية
ملاحظات
عادةً، يتم تنفيذ دمج البريد فقط في حقول MERGEFIELD، ولكن العديد من العملاء كان لديهم تقاريرهم مبنية باستخدام حقول أخرى وكان لديهم العديد من الوثائق التي أنشئت بهذه الطريقة. لتبسيط الهجرة (ولأن هذا النهج تم استخدامه بشكل مستقل من قبل عدة عملاء) تم تقديم القدرة على دمج البريد في حقول أخرى.
عندما يتم تعيين Aspose.Words.LowCode.MailMergeOptions.UseNonMergeFields إلى true
، ستقوم Aspose.Words بتنفيذ دمج البريد في الحقول التالية:
MERGEFIELD FieldName
MACROBUTTON NOMACRO FieldName
IF 0 = 0 "{FieldName}" ""
أيضًا، عندما يتم تعيين Aspose.Words.LowCode.MailMergeOptions.UseNonMergeFields إلى true
، ستقوم Aspose.Words بتنفيذ دمج البريد في علامات النص "{{fieldName}}". هذه ليست حقولًا، بل مجرد علامات نصية.
UseWholeParagraphAsRegion
يحصل أو يحدد قيمة تشير إلى ما إذا كان يجب تضمين الفقرة بأكملها مع حقل TableStart أو TableEnd أو نطاق معين بين حقلي TableStart وTableEnd في منطقة دمج البريد.
public bool UseWholeParagraphAsRegion { get; set; }
قيمة الخاصية
ملاحظات
القيمة الافتراضية هي true
.