MailMergeSettings

MailMergeSettings class

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

لمعرفة المزيد، قم بزيارةدمج البريد وإعداد التقارير مقالة توثيقية.

public class MailMergeSettings

المنشئون

اسموصف
MailMergeSettings()Default_Constructor

الخصائص

اسموصف
ActiveRecord { get; set; }يُحدد فهرس السجل من مصدر البيانات الذي سيتم عرضه في Microsoft Word. القيمة الافتراضية هي 1.
AddressFieldName { get; set; }يحدد العمود الذي يحتوي على عناوين البريد الإلكتروني في مصدر البيانات. القيمة الافتراضية هي سلسلة فارغة.
CheckErrors { get; set; }يحدد نوع تقرير الخطأ الذي يجب أن يقوم به Microsoft Word عند تنفيذ دمج البريد. القيمة الافتراضية هيDefault .
ConnectString { get; set; }يحدد سلسلة الاتصال المستخدمة للاتصال بمصدر بيانات خارجي. القيمة الافتراضية سلسلة فارغة.
DataSource { get; set; }يحدد مسار مصدر بيانات دمج البريد. القيمة الافتراضية هي سلسلة فارغة.
DataType { get; set; }يحدد نوع مصدر بيانات الدمج البريدي وطريقة الوصول إلى البيانات. القيمة الافتراضية هيDefault .
Destination { get; set; }يحدد كيفية قيام Microsoft Word بإخراج نتائج دمج البريد. القيمة الافتراضية هيDefault .
DoNotSupressBlankLines { get; set; }يحدد كيفية تعامل التطبيق الذي يقوم بدمج البريد مع الأسطر الفارغة في المستندات المدمجة الناتجة عن دمج البريد. القيمة الافتراضية هيخطأ شنيع .
HeaderSource { get; set; }يحدد المسار إلى مصدر رأس الدمج البريدي. القيمة الافتراضية هي سلسلة فارغة.
LinkToQuery { get; set; }لست متأكدًا من هذا. يشير مرجع أتمتة مايكروسوفت وورد إلى أن هذا يُحدد تنفيذ الاستعلام في كل مرة يُفتح فيها المستند في مايكروسوفت وورد. لكن مواصفات OOXML تُشير إلى أن هذا يُحدد أن الاستعلام يحتوي على مرجع لملف استعلام خارجي يحتوي على الاستعلام الفعلي. القيمة الافتراضية هيخطأ شنيع .
MailAsAttachment { get; set; }يُحدد أنه يجب إرسال المستندات الناتجة أثناء عملية دمج البريد كمرفقات بدلاً من كنص للبريد الإلكتروني نفسه. القيمة الافتراضية هيخطأ شنيع .
MailSubject { get; set; }يحدد النص الذي يجب أن يظهر في سطر الموضوع في رسائل البريد الإلكتروني أو الفاكسات التي يتم إنتاجها أثناء دمج البريد. القيمة الافتراضية هي سلسلة فارغة.
MainDocumentType { get; set; }يحدد نوع المستند الرئيسي للدمج البريدي. القيمة الافتراضية هيDefault .
Odso { get; set; }يحصل على الكائن الذي يحدد إعدادات كائن مصدر بيانات Office (ODSO) أو يعينه.
Query { get; set; }يحتوي على سلسلة لغة الاستعلام المنظمة التي يجب تشغيلها على مصدر البيانات الخارجي المحدد لـ إرجاع مجموعة السجلات التي يجب استيرادها إلى المستند عند تنفيذ عملية دمج البريد. القيمة الافتراضية هي سلسلة فارغة.
ViewMergedData { get; set; }يُحدد أن مايكروسوفت وورد سيعرض البيانات من مصدر البيانات الخارجي المُحدد الذي أُدرجت فيه حقول الدمج (مثل معاينة البيانات المدمجة). القيمة الافتراضية هيخطأ شنيع .

طُرق

اسموصف
Clear()يقوم بمسح إعدادات دمج البريد بطريقة تجعل لا يتم حفظ أي إعدادات لدمج البريد عند حفظ المستند، وسيصبح مستندًا عاديًا.
Clone()يعيد نسخة طبق الأصل من هذا الكائن.

ملاحظات

يمكنك استخدام هذا الكائن لتحديد مصدر بيانات دمج البريد لمستند، وستظهر هذه المعلومات (إلى جانب حقول البيانات المتوفرة) في Microsoft Word عندما يفتح المستخدم هذا المستند. أو يمكنك استخدام هذا الكائن للاستعلام عن إعدادات دمج البريد التي حددها المستخدم في Microsoft Word لهذا المستند.

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

لكشف ما إذا كان هذا المستند مستندًا رئيسيًا لدمج البريد، تحقق من قيمة MainDocumentType ملكية.

لإزالة إعدادات دمج البريد ومعلومات مصدر البيانات من مستند، يمكنك استخدام Clear الطريقة. لن يكتب Aspose.Words إعدادات دمج البريد إلى مستند إذا كان MainDocumentType تم تعيين الخاصية إلىNotAMergeDocument أوDataType تم تعيين الخاصية إلىNone.

أفضل طريقة لتعلم كيفية استخدام خصائص هذا الكائن هي إنشاء مستند بمصدر بيانات المطلوب يدويًا في Microsoft Word ثم فتح هذا المستند باستخدام Aspose.Words وفحص خصائص MailMergeSettings وOdso الكائنات. هذا هو نهج جيد يمكنك اتباعه إذا كنت تريد أن تتعلم كيفية تكوين مصدر بيانات برمجيًا، على سبيل المثال.

يحتفظ Aspose.Words بمعلومات دمج البريد عند تحميل المستندات وحفظها وتحويلها بين تنسيقات مختلفة، ولكنه لا يستخدم هذه المعلومات عند تنفيذ دمج البريد الخاص به باستخدامMailMerge هدف.

أمثلة

يوضح كيفية تنفيذ دمج البريد باستخدام البيانات من كائن مصدر بيانات Office.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Dear ");
builder.InsertField("MERGEFIELD FirstName", "<FirstName>");
builder.Write(" ");
builder.InsertField("MERGEFIELD LastName", "<LastName>");
builder.Writeln(": ");
builder.InsertField("MERGEFIELD Message", "<Message>");

// إنشاء مصدر بيانات في شكل ملف ASCII، مع حرف "|"
// يعمل كفاصل يفصل الأعمدة. يحتوي السطر الأول على أسماء الأعمدة الثلاثة.
// وكل سطر لاحق هو صف مع القيم الخاصة به.
string[] lines = { "FirstName|LastName|Message",
    "John|Doe|Hello! This message was created with Aspose Words mail merge." };
string dataSrcFilename = ArtifactsDir + "MailMerge.MailMergeSettings.DataSource.txt";

File.WriteAllLines(dataSrcFilename, lines);

MailMergeSettings settings = doc.MailMergeSettings;
settings.MainDocumentType = MailMergeMainDocumentType.MailingLabels;
settings.CheckErrors = MailMergeCheckErrors.Simulate;
settings.DataType = MailMergeDataType.Native;
settings.DataSource = dataSrcFilename;
settings.Query = "SELECT * FROM " + doc.MailMergeSettings.DataSource;
settings.LinkToQuery = true;
settings.ViewMergedData = true;

Assert.AreEqual(MailMergeDestination.Default, settings.Destination);
Assert.False(settings.DoNotSupressBlankLines);

Odso odso = settings.Odso;
odso.DataSource = dataSrcFilename;
odso.DataSourceType = OdsoDataSourceType.Text;
odso.ColumnDelimiter = '|';
odso.FirstRowContainsColumnNames = true;

Assert.AreNotSame(odso, odso.Clone());
Assert.AreNotSame(settings, settings.Clone());

 // سيؤدي فتح هذا المستند في Microsoft Word إلى تنفيذ دمج البريد قبل عرض المحتويات.
doc.Save(ArtifactsDir + "MailMerge.MailMergeSettings.docx");

أنظر أيضا

MailMergeMainDocumentType Enum MsWordVersion Enum