خاصية قيمة XML
يوفر طريقة للوصول إلى قيمة العنصر الأول من مجموعة من XElement الكائنات.
object.Value
الأجزاء
- object
مطلوبة. مجموعة من XElement الكائنات.
القيمة المُرجعة
String الذي يحتوي على قيمة العنصر الأول من المجموعة, أو Nothing إذا كانت المجموعة فارغة.
ملاحظات
Value الخاصية تجعل من السهل الوصول إلى قيمة العنصر الأول في مجموعة من XElement الكائنات. هذه خاصية تتحقق أولا ما إذا كانت المجموعة تحتوي على كائن واحد على الأقل. إذا كانت المجموعة فارغه، هذه خاصية تقوم بإرجاع Nothing. وخلاف ذلك، ترجع هذه الخاصية قيمة Value خاصية العنصر الأول في المجموعة.
ملاحظة
عندما تحاول الوصول إلى قيمة سمة الـ XML باستخدام معرّف الـ "@"، يتم إرجاع قيمة السمة كــ String و لَسْتَ بِحاجةٍ إلى أَنْ تُحدّدَ بشكل واضح الـ Value الخاصية.
للوصول إلى عناصر أخرى في مجموعة, يمكنك استخدام خاصية المفهرس الملحق لـ XML. لمزيد من المعلومات، راجع خاصية مفهرس الملحق.
الوراثة
لا يحتاج معظم المستخدمون إلى تنفيذ IEnumerable<T>، وبالتالي يمكنك تجاهل هذا مقطع.
Value الخاصية عباره عن خاصية امتداد لـ أنواع تنفذ الــ IEnumerable(Of XElement). إنّ ربط خاصية الامتداد هذه مثل ربط طرق الامتداد : إذا كان نوع يطبّق أحد الواجهات و يعرف خاصية تحمل اسم "القيمة", تلك الخاصية لها الأسبقية على الخاصية الملحقه. في تعبير أخرى Value الخاصية يمكن إبطالها بواسطة تعريف خاصية جديدة في فئة التي تطبق IEnumerable(Of XElement).
مثال
يظهر المثال التالي كيفية استخدام Value الخاصية للوصول إلى العقدة الأولى في مجموعة من 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("Phone number: " & contact.<phone>.Value)
هذه التعليمات البرمجية يعرض نص التالي:
Phone number: 206-555-0144
يظهر المثال التالي كيفية الحصول على قيمة سمة الـ XML من مجموعة من XAttribute الكائنات. يستخدم المثال خاصية سمة المحور لعرض قيمة type السمة لكافة phone العناصر.
Dim contact As XElement =
<contact>
<name>Patrick Hines</name>
<phone type="home">206-555-0144</phone>
<phone type="work">425-555-0145</phone>
</contact>
Dim types = contact.<phone>.Attributes("type")
For Each attr In types
Console.WriteLine(attr.Value)
Next
هذه التعليمات البرمجية يعرض نص التالي:
home
work