OdsoRecipientData

OdsoRecipientData class

يمثل معلومات حول سجل واحد ضمن مصدر بيانات خارجي ليتم استبعاده من دمج البريد.

public class OdsoRecipientData

المنشئون

اسم وصف
OdsoRecipientData() Default_Constructor

الخصائص

اسم وصف
Active { get; set; } يحدد ما إذا كان يجب استيراد السجل من مصدر البيانات إلى مستند عند تنفيذ دمج البريد. القيمة الافتراضية هيحقيقي .
Column { get; set; } يحدد العمود داخل مصدر البيانات الذي يحتوي على بيانات فريدة للسجل الحالي. القيمة الافتراضية هي 0.
Hash { get; set; } يمثل رمز التجزئة لهذا السجل. يستخدم Microsoft Word أحيانًاHash من سجل كامل بدلاً من ملفUniqueTag value. القيمة الافتراضية هي 0.
UniqueTag { get; set; } يحدد محتويات سجل معين في العمود الذي يحتوي على بيانات فريدة. القيمة الافتراضية هيلا شيء .

طُرق

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

ملاحظات

إذا تم دمج سجل في مستند مدمج ، فلن تكون هناك حاجة إلى معلومات حول هذا السجل. ومع ذلك ، إذا لم يتم دمج سجل معين في مستند مدمج ، فيجب تخزين قيمة المفتاح الفريد لهذا السجل فيUniqueTag خاصية هذا الكائن للإشارة إلى هذا الاستبعاد.

أمثلة

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

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

OdsoRecipientDataCollection dataCollection = doc.MailMergeSettings.Odso.RecipientDatas;

Assert.AreEqual(70, dataCollection.Count);

using (IEnumerator<OdsoRecipientData> enumerator = dataCollection.GetEnumerator())
{
    int index = 0;
    while (enumerator.MoveNext())
    {
        Console.WriteLine(
            $"Odso recipient data index {index++} will {(enumerator.Current.Active ? "" : "not ")}be imported upon mail merge.");
        Console.WriteLine($"\tColumn #{enumerator.Current.Column}");
        Console.WriteLine($"\tHash code: {enumerator.Current.Hash}");
        Console.WriteLine($"\tContents array length: {enumerator.Current.UniqueTag.Length}");
    }
}

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

// يمكننا أيضًا إزالة العناصر بشكل فردي ، أو مسح المجموعة بأكملها مرة واحدة.
dataCollection.RemoveAt(0);

Assert.AreEqual(69, dataCollection.Count);

dataCollection.Clear();

Assert.AreEqual(0, dataCollection.Count);

أنظر أيضا