خاصية المحور التابع XML
يوفر الوصول إلى توابع أحد الإجراءات التالية: كائن XElement XDocument الكائن عبارة عن مجموعة من كائنات XElement , أو مجموعة من كائنات XDocument .
object.<child>
الأجزاء
object
مطلوبة. كائن XElement XDocument الكائن عبارة عن مجموعة من كائنات XElement , أو مجموعة من كائنات XDocument ..<
مطلوبة. يـشير إلى بداية خاصية المحور الفرع.child
مطلوبة. اسم فرع العقد للاتصال على شكل [prefix:]name .جزء
الوصف
prefix
اختياري. بادئة مساحة الاسم XML للعقدة التابعه . يجب أن تكون مساحة اسم XML عمومية تعريف مع كشف Imports.
name
مطلوبة. اسم العقدة الفرعي المحلي. انظر أسماء عناصر XML المُعلَنة و السمات
>
مطلوبة. يـشير إلى نهاية خاصية المحور الفرع.
القيمة المُرجعة
مجموعة من كائنات XElement.
ملاحظات
يمكنك استخدام خاصية محور فرع XML للوصول إلى عقد الفرع حسب الاسم من XElement أو كائن XDocument , أو من مجموعة من XElement أو كائنات XDocument . استخدام خاصية XML Value للوصول إلى قيمة عقدة الفرع الأولى في المجموعة التي تم إرجاعها. لمزيد من المعلومات، راجع خاصية قيمة XML.
برنامج التحويل البرمجي Visual Basic يحول خصائص محور الفرع لنداء أسلوب Elements .
مساحة أسماء XML،
الاسم الموجود في خاصية محور الفرع يمكن أن تستخدم فقط بادئات مساحات الأسماء XML التي تم تعريفها بشكل عمومي باستخدام عبارة Imports . لا يمكنه استخدام بادئات مساحات الأسماء XML المعّرفة محلياً داخل حرفية عنصر XML. لمزيد من المعلومات، راجع استيراد عبارات (مساحة الاسم XML).
مثال
يظهر المثال التالي كيفية الوصول إلى عقد الفرع باسم 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>
Dim homePhone = From hp In contact.<phone>
Where contact.<phone>.@type = "home"
Select hp
Console.WriteLine("Home Phone = {0}", homePhone(0).Value)
هذه التعليمات البرمجية يعرض نص التالي:
Home Phone = 206-555-0144
يظهر المثال التالي كيفية الوصول إلى عقد الفرع باسم phone من مجموعة تم إرجاعها بواسطة contact خاصية محور الفرع لكائن contacts .
Dim contacts As XElement =
<contacts>
<contact>
<name>Patrick Hines</name>
<phone type="home">206-555-0144</phone>
</contact>
<contact>
<name>Lance Tucker</name>
<phone type="work">425-555-0145</phone>
</contact>
</contacts>
Dim homePhone = From contact In contacts.<contact>
Where contact.<phone>.@type = "home"
Select contact.<phone>
Console.WriteLine("Home Phone = {0}", homePhone(0).Value)
هذه التعليمات البرمجية يعرض نص التالي:
Home Phone = 206-555-0144
يقوم المثال التالي بتعريف ns كبادئة مساحة الاسم XML. ثم تستخدم بادئة مساحة الاسم لإنشاء قيمة XML حرفية والوصول إلى أول عقدة تابعة مع الاسم المؤهل ns:name.
Imports <xmlns:ns = "http://SomeNamespace">
Class TestClass4
Shared Sub TestPrefix()
Dim contact = <ns:contact>
<ns:name>Patrick Hines</ns:name>
</ns:contact>
Console.WriteLine(contact.<ns:name>.Value)
End Sub
End Class
هذه التعليمات البرمجية يعرض نص التالي:
Patrick Hines
راجع أيضًا:
المرجع
المبادئ
أسماء عناصر XML المُعلَنة و السمات