OdsoFieldMapData

OdsoFieldMapData class

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

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

public class OdsoFieldMapData

المنشئون

اسموصف
OdsoFieldMapData()Default_Constructor

الخصائص

اسموصف
Column { get; set; }يحدد الفهرس الصفري للعمود داخل مصدر بيانات خارجي والذي يجب أن يتم تعيينه إلى الاسم المحلي لحقل MERGEFIELD محدد. القيمة الافتراضية هي 0.
MappedName { get; set; }يحدد اسم حقل الدمج المحدد مسبقًا والذي يجب تعيينه إلى رقم العمود المحدد بواسطةColumn الخاصية ضمن تعيين هذا الحقل. القيمة الافتراضية هي سلسلة فارغة.
Name { get; set; }يحدد اسم العمود ضمن مصدر بيانات خارجي للعمود الذي تم تحديد فهرسه بواسطةColumnproperty. القيمة الافتراضية هي سلسلة فارغة.
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);

أنظر أيضا

OdsoDataSourceType Enum OdsoFieldMapDataCollection Class