VariableCollection

VariableCollection class

مجموعة من متغيرات الوثيقة.

لمعرفة المزيد، قم بزيارةالعمل مع خصائص الوثيقة مقالة توثيقية.

public class VariableCollection : IEnumerable<KeyValuePair<string, string>>

الخصائص

اسموصف
Count { get; }الحصول على عدد العناصر الموجودة في المجموعة.
Item { get; set; }الحصول على متغير مستند أو تعيينه باستخدام اسم غير حساس لحالة الأحرف. باطل لا يُسمح بالقيم في الجانب الأيمن من المهمة وسيتم استبدالها بسلسلة فارغة. (2 indexers)

طُرق

اسموصف
Add(string, string)إضافة متغير مستند إلى المجموعة.
Clear()إزالة كافة العناصر من المجموعة.
Contains(string)تحديد ما إذا كانت المجموعة تحتوي على متغير مستند بالاسم المحدد.
GetEnumerator()يُرجع كائن العداد الذي يمكن استخدامه للتكرار على كافة المتغيرات في المجموعة.
IndexOfKey(string)إرجاع الفهرس الصفري لمتغير المستند المحدد في المجموعة.
Remove(string)إزالة متغير مستند بالاسم المحدد من المجموعة.
RemoveAt(int)إزالة متغير مستند في الفهرس المحدد.

ملاحظات

أسماء وقيم المتغيرات هي سلاسل.

أسماء المتغيرات غير حساسة لحالة الأحرف.

أمثلة

يوضح كيفية العمل مع مجموعة متغيرات المستند.

Document doc = new Document();
VariableCollection variables = doc.Variables;

// يحتوي كل مستند على مجموعة من متغيرات زوج المفتاح/القيمة، والتي يمكننا إضافة عناصر إليها.
variables.Add("Home address", "123 Main St.");
variables.Add("City", "London");
variables.Add("Bedrooms", "3");

Assert.AreEqual(3, variables.Count);

// يمكننا عرض قيم المتغيرات في نص الوثيقة باستخدام حقول DOCVARIABLE.
DocumentBuilder builder = new DocumentBuilder(doc);
FieldDocVariable field = (FieldDocVariable)builder.InsertField(FieldType.FieldDocVariable, true);
field.VariableName = "Home address";
field.Update();

Assert.AreEqual("123 Main St.", field.Result);

// سيؤدي تعيين القيم للمفاتيح الموجودة إلى تحديثها.
variables.Add("Home address", "456 Queen St.");

// سيتعين علينا بعد ذلك تحديث حقول DOCVARIABLE للتأكد من أنها تعرض قيمة محدثة.
Assert.AreEqual("123 Main St.", field.Result);

field.Update();

Assert.AreEqual("456 Queen St.", field.Result);

// التحقق من وجود متغيرات المستند ذات اسم أو قيمة معينة.
Assert.True(variables.Contains("City"));
Assert.True(variables.Any(v => v.Value == "London"));

// تقوم مجموعة المتغيرات بفرز المتغيرات أبجديًا حسب الاسم تلقائيًا.
Assert.AreEqual(0, variables.IndexOfKey("Bedrooms"));
Assert.AreEqual(1, variables.IndexOfKey("City"));
Assert.AreEqual(2, variables.IndexOfKey("Home address"));

// تعداد مجموعة المتغيرات.
using (IEnumerator<KeyValuePair<string, string>> enumerator = doc.Variables.GetEnumerator())
    while (enumerator.MoveNext())
        Console.WriteLine($"Name: {enumerator.Current.Key}, Value: {enumerator.Current.Value}");

// فيما يلي ثلاث طرق لإزالة متغيرات المستند من المجموعة.
// 1 - بالاسم:
variables.Remove("City");

Assert.False(variables.Contains("City"));

// 2 - حسب الفهرس:
variables.RemoveAt(1);

Assert.False(variables.Contains("Home address"));

// 3 - مسح المجموعة بأكملها مرة واحدة:
variables.Clear();

Assert.That(variables, Is.Empty);

أنظر أيضا