Odso

Odso class

يحدد إعدادات كائن مصدر بيانات Office (ODSO) لمصدر بيانات دمج المراسلات.

public class Odso

المنشئون

اسم وصف
Odso() Default_Constructor

الخصائص

اسم وصف
ColumnDelimiter { get; set; } يحدد الحرف الذي يجب تفسيره على أنه محدد العمود المستخدم لفصل الأعمدة داخل مصادر البيانات الخارجية. القيمة الافتراضية هي 0 مما يعني عدم وجود محدد عمود محدد.
DataSource { get; set; } يحدد موقع مصدر البيانات الخارجي الذي سيتم توصيله بمستند لإجراء دمج البريد. القيمة الافتراضية هي سلسلة فارغة.
DataSourceType { get; set; } يحدد نوع مصدر البيانات الخارجي الذي سيتم الاتصال به كجزء من معلومات اتصال ODSO لدمج البريد هذا. القيمة الافتراضية هيDefault .
FieldMapDatas { get; set; } الحصول على أو تعيين مجموعة من الكائنات التي تحدد كيفية تعيين الأعمدة من مصدر البيانات الخارجي إلى أسماء حقول الدمج المحددة مسبقًا في المستند.
FirstRowContainsColumnNames { get; set; } يحدد أن تطبيق الاستضافة يجب أن يتعامل مع الصف الأول من البيانات في مصدر data الخارجية المحدد كصف رأس يحتوي على أسماء كل عمود في مصدر البيانات. القيمة الافتراضية هيخاطئة .
RecipientDatas { get; set; } الحصول على أو تعيين مجموعة من الكائنات التي تحدد تضمين / استبعاد السجلات الفردية في دمج المراسلات . هذا الكائن ليس فارغًا أبدًا.
TableName { get; set; } يحدد مجموعة معينة من البيانات التي يجب أن يتصل بها المصدر داخل مصدر بيانات خارجي. القيمة الافتراضية هي سلسلة فارغة .
UdlConnectString { get; set; } تحدد سلسلة اتصال ارتباط البيانات العالمي (UDL) المستخدمة للاتصال بمصدر بيانات خارجي . القيمة الافتراضية هي سلسلة فارغة.

طُرق

اسم وصف
Clone() إرجاع نسخة عميقة من هذا الكائن.

ملاحظات

يبدو أن ODSO هو الطريقة “الجديدة” التي تفضل إصدارات Microsoft Word الأحدث استخدامها عند تحديد أنواع معينة من مصادر البيانات لمستند دمج المراسلات. ربما ظهر ODSO لأول مرة في Microsoft Word 2000.

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

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

أمثلة

يوضح كيفية تنفيذ دمج البريد مع البيانات من كائن مصدر بيانات 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");

أنظر أيضا