Class MailMergeOptions

Class MailMergeOptions

Namespace: Aspose.Words.LowCode
Assembly: Aspose.Words.dll

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

public class MailMergeOptions

الوراثة

objectMailMergeOptions

الأعضاء الموروثة

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; }

قيمة الخاصية

MailMergeCleanupOptions

CleanupParagraphsWithPunctuationMarks

يحصل أو يحدد قيمة تشير إلى ما إذا كانت الفقرات التي تحتوي على علامات ترقيم تعتبر فارغة ويجب إزالتها إذا تم تحديد خيار Aspose.Words.MailMerging.MailMergeCleanupOptions.RemoveEmptyParagraphs.

public bool CleanupParagraphsWithPunctuationMarks { get; set; }

قيمة الخاصية

bool

ملاحظات

القيمة الافتراضية هي true.

MergeDuplicateRegions

يحصل أو يحدد قيمة تشير إلى ما إذا كانت جميع مناطق دمج البريد في الوثيقة التي تحمل اسم مصدر البيانات يجب دمجها أثناء تنفيذ دمج البريد مع المناطق ضد مصدر البيانات أو فقط الأولى.

public bool MergeDuplicateRegions { get; set; }

قيمة الخاصية

bool

ملاحظات

القيمة الافتراضية هي false.

MergeWholeDocument

يحصل أو يحدد قيمة تشير إلى ما إذا كانت الحقول في الوثيقة بأكملها يتم تحديثها أثناء تنفيذ دمج البريد مع المناطق.

public bool MergeWholeDocument { get; set; }

قيمة الخاصية

bool

ملاحظات

القيمة الافتراضية هي false.

PreserveUnusedTags

يحصل أو يحدد قيمة تشير إلى ما إذا كانت العلامات “المستعملة” يجب أن تُحفظ.

public bool PreserveUnusedTags { get; set; }

قيمة الخاصية

bool

ملاحظات

القيمة الافتراضية هي false.

انظر أيضًا

MailMergeOptions.UseNonMergeFields

RegionEndTag

يحصل أو يحدد علامة نهاية منطقة دمج البريد.

public string RegionEndTag { get; set; }

قيمة الخاصية

string

RegionStartTag

يحصل أو يحدد علامة بداية منطقة دمج البريد.

public string RegionStartTag { get; set; }

قيمة الخاصية

string

RestartListsAtEachSection

يحصل أو يحدد قيمة تشير إلى ما إذا كانت القوائم تُعاد بدءها في كل قسم بعد تنفيذ دمج البريد.

public bool RestartListsAtEachSection { get; set; }

قيمة الخاصية

bool

ملاحظات

القيمة الافتراضية هي true.

RetainFirstSectionStart

يحصل أو يحدد قيمة تشير إلى ما إذا كانت بداية القسم من القسم الأول في الوثيقة ونسخها لصفوف مصدر البيانات التالية تُحتفظ بها أثناء دمج البريد أو يتم تحديثها وفقًا لسلوك MS Word.

public bool RetainFirstSectionStart { get; set; }

قيمة الخاصية

bool

ملاحظات

القيمة الافتراضية هي true.

TrimWhitespaces

يحصل أو يحدد قيمة تشير إلى ما إذا كانت المسافات الفارغة المتبقية والمقدمة تُقص من قيم دمج البريد.

public bool TrimWhitespaces { get; set; }

قيمة الخاصية

bool

ملاحظات

القيمة الافتراضية هي true.

UnconditionalMergeFieldsAndRegions

يحصل أو يحدد قيمة تشير إلى ما إذا كانت حقول الدمج ومناطق الدمج تُدمج بغض النظر عن شرط حقل IF الأب.

public bool UnconditionalMergeFieldsAndRegions { get; set; }

قيمة الخاصية

bool

ملاحظات

القيمة الافتراضية هي false.

UseNonMergeFields

عندما تكون true، تحدد أنه بالإضافة إلى حقول MERGEFIELD، يتم تنفيذ دمج البريد في بعض الأنواع الأخرى من الحقول وأيضًا في علامات “{{fieldName}}”.

public bool UseNonMergeFields { get; set; }

قيمة الخاصية

bool

ملاحظات

عادةً، يتم تنفيذ دمج البريد فقط في حقول 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; }

قيمة الخاصية

bool

ملاحظات

القيمة الافتراضية هي true.

 عربي