OdsoFieldMapData

OdsoFieldMapData class

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

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

public class OdsoFieldMapData

المنشئون

اسموصف
OdsoFieldMapData()Default_Constructor

الخصائص

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

طُرق

اسموصف
Clone()يعيد نسخة طبق الأصل من هذا الكائن.

ملاحظات

يوفر مايكروسوفت وورد بعض أسماء حقول الدمج المُعرّفة مسبقًا، والتي تسمح بإدراجها في مستند، مثل استخدام 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);

أنظر أيضا

OdsoDataSourceType Enum OdsoFieldMapDataCollection Class