خاصية مفهرس الملحق
يوفر الوصول إلى عناصر فردية في مجموعة.
object(index)
الأجزاء
object
مطلوبة. مجموعة قابلة للتساؤل. وهو, المجموعة التي تطبّق IEnumerable<T> أو IQueryable<T>.(
مطلوبة. يـشير إلى بداية خاصية المفهرس.index
مطلوبة. تعبير عدد صحيح الذي يحدد الموضع ذو الأساس صفر لعنصر في مجموعة.)
مطلوبة. يـشير إلى نهاية خاصية المفهرس.
القيمة المُرجعة
الكائن من الموقع المحدد في المجموعة أو Nothing إذا كان الفهرس خارج النطاق.
ملاحظات
للوصول إلى عناصر فردية في مجموعة, يمكنك استخدام خاصية المفهرس الملحق. عادةً ما يتم استخدام خاصية المفهرس هذه على إخراج خصائص محور XML. فرع XML و خصائص محور XML المتحدرة تقوم بإرجاع مجموعات من XElement الكائنات أو قيمة سمة.
برنامج التحويل البرمجي Visual Basic يحول خصائص مفهرس الملحق الى استدعاءات لـ ElementAtOrDefault الأسلوب. بعكس مفهرس الصفيف ElementAtOrDefault الأسلوب يقوم بإرجاع Nothing إذا لم يكن الفهرس خارج النطاق. يفيد هذا السلوك عندما يتعذر تحديد بسهولة رقم العناصر في مجموعة.
خاصية المفهرس هذه تشبه خاصية الملحق للمجموعات التي تقوم بتطبيق IEnumerable<T> أو IQueryable<T>: تـستخدم فقط إذا لم يكن لدى المجموعة مفهرس أو خاصية افتراضية.
للوصول الى قيمة العنصر الأول في مجموعة من XElement أو XAttribute الكائنات, يمكنك استخدام خاصية Value لـ XML . لمزيد من المعلومات، راجع خاصية قيمة XML.
مثال
يظهر المثال التالي كيفية استخدام مفهرس الملحق للوصول إلى ثاني عقدة فرع في مجموعة من XElement الكائنات. يتم الوصول إلى المجموعة باستخدام خاصية محور الفرع, الذي يحصل على كل عناصر الفرع باسم phone في contact الكائن.
Dim contact As XElement =
<contact>
<name>Patrick Hines</name>
<phone type="home">206-555-0144</phone>
<phone type="work">425-555-0145</phone>
</contact>
Console.WriteLine("Second phone number: " & contact.<phone>(1).Value)
هذه التعليمات البرمجية يعرض نص التالي:
Second phone number: 425-555-0145