OdsoFieldMapData

OdsoFieldMapData class

يحدد كيفية تعيين عمود في مصدر البيانات الخارجي إلى حقول الدمج المحددة مسبقًا داخل المستند.

public class OdsoFieldMapData

المنشئون

اسم وصف
OdsoFieldMapData() Default_Constructor

الخصائص

اسم وصف
Column { get; set; } يحدد الفهرس الصفري للعمود داخل مصدر بيانات خارجي والذي يجب تعيينه إلى الاسم المحلي لحقل MERGEFIELD محدد. القيمة الافتراضية هي 0.
MappedName { get; set; } يحدد اسم حقل الدمج المحدد مسبقًا والذي يجب تعيينه إلى رقم العمود المحدد بواسطةColumn الخاصية داخل تعيين الحقل هذا . القيمة الافتراضية هي سلسلة فارغة.
Name { get; set; } يحدد اسم العمود داخل مصدر بيانات خارجي للعمود الذي تم تحديد فهرسه بواسطةColumn property. القيمة الافتراضية هي سلسلة فارغة.
Type { get; set; } تحديد ما إذا كان قد تم تعيين حقل دمج المراسلات لعمود في مصدر البيانات الخارجية المحدد أم لا. القيمة الافتراضية هيDefault .

طُرق

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

ملاحظات

يوفر Microsoft Word بعض أسماء حقول الدمج المعرفة مسبقًا التي تسمح بإدراجها في مستند مثل MERGEFIELD أو في حقول ADDRESSBLOCK أو GREETINGLINE. المعلومات المحددة فيOdsoFieldMapData يسمح بتعيين عمود واحد في مصدر البيانات الخارجي إلى حقل دمج واحد محدد مسبقًا.

أمثلة

يوضح كيفية الوصول إلى مجموعة البيانات التي تعين أعمدة مصدر البيانات لدمج الحقول.

Document doc = new Document(MyDir + "Odso data.docx");

// تحدد هذه المجموعة كيف سيقوم دمج البريد بتعيين أعمدة من مصدر بيانات
// إلى حقول MERGEFIELD و ADDRESSBLOCK و GREETINGLINE المحددة مسبقًا.
OdsoFieldMapDataCollection dataCollection = doc.MailMergeSettings.Odso.FieldMapDatas;
Assert.AreEqual(30, dataCollection.Count);

using (IEnumerator<OdsoFieldMapData> enumerator = dataCollection.GetEnumerator())
{
    int index = 0;
    while (enumerator.MoveNext())
    {
        Console.WriteLine($"Field map data index {index++}, type \"{enumerator.Current.Type}\":");

        Console.WriteLine(
            enumerator.Current.Type != OdsoFieldMappingType.Null
                ? $"\tColumn \"{enumerator.Current.Name}\", number {enumerator.Current.Column} mapped to merge field \"{enumerator.Current.MappedName}\"."
                : "\tNo valid column to field mapping data present.");
    }
}

// استنساخ العناصر في هذه المجموعة.
Assert.AreNotEqual(dataCollection[0], dataCollection[0].Clone());

// استخدم عناصر طريقة "RemoveAt" بشكل فردي عن طريق الفهرس.
dataCollection.RemoveAt(0);

Assert.AreEqual(29, dataCollection.Count);

// استخدم طريقة "المسح" لمسح المجموعة بأكملها مرة واحدة.
dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

أنظر أيضا