عامل التشغيل GetXmlNamespace

يحصل على الكائن XNamespace الذي يتوافق مع بادئة مساحة اسم XML المحدد.

GetXmlNamespace(xmlNamespacePrefix)

الأجزاء

• xmlNamespacePrefix
  اختياري. السلسلة التي تعرّف بادئة مساحة اسم XML. إذا زودت، يجب أن تكون هذه السلسلة معرّف XML صالح. لمزيد من المعلومات، راجع أسماء عناصر XML المُعلَنة و السمات. إذا لم يتم تحديد بادئة، سيتم إرجاع مساحة الاسم الافتراضية. إذا لم يتم تحديد مساحة اسم افتراضية، سيتم إرجاع مساحة الاسم الفارغة.

القيمة المُرجعة

الكائن XNamespace الذي يتوافق مع بادئة مساحة اسم XML.

ملاحظات

عامل التشغيل GetXmlNamespace يحصل على الكائن XNamespace الذي يتوافق مع بادئة مساحة اسم XML xmlNamespacePrefix.

يمكنك استخدام بادئات مساحة اسم XML بشكل مباشر في القيم الحرفية XML وخصائص محور XML. مع ذلك، يجب استخدام عامل التشغيل GetXmlNamespace لتحويل بادئة مساحة الاسم إلى كائن XNamespace قبل أن تتمكن من استخدامه في التعليمات البرمجية الخاصة بك. يمكنك إلحاق اسم عنصر غير مؤهل إلى كائن XNamespace للحصول على كائن XName كامل التأهيل، الذي تتطلبه العديد من أساليب مكون LINQ to XML.

مثال

يقوم المثال التالي باستيراد ns كبادئة مساحة اسم XML. ثم تستخدم بادئة مساحة الاسم لإنشاء قيمة حرفية لمستند XML و الوصول إلى أول عقدة تابعة لها الاسم المؤهل ns:phone. تم تقوم بتمرير تلك العقدة التابعة إلى الروتين الفرعي ShowName، الذي يقوم بإنشاء اسم مؤهل باستخدام عامل تشغيل GetXmlNamespace. ثم يقوم الروتين الفرعي ShowName بتمرير اسم مؤهل إلى الأسلوب Ancestors للحصول على عقدة أصل ns:contact.

' Place Imports statements at the top of your program.  
Imports <xmlns:ns="http://SomeNamespace">

Module GetXmlNamespaceSample

    Sub RunSample()

        ' Create test by using a global XML namespace prefix. 

        Dim contact = 
            <ns:contact>
                <ns:name>Patrick Hines</ns:name>
                <ns:phone ns:type="home">206-555-0144</ns:phone>
                <ns:phone ns:type="work">425-555-0145</ns:phone>
            </ns:contact>

        ShowName(contact.<ns:phone>(0))
    End Sub

    Sub ShowName(ByVal phone As XElement)
        Dim qualifiedName = GetXmlNamespace(ns) + "contact"
        Dim contact = phone.Ancestors(qualifiedName)(0)
        Console.WriteLine("Name: " & contact.<ns:name>.Value)
    End Sub

End Module

عندما تقوم باستدعاء TestGetXmlNamespace.RunSample()، يقوم بعرض مربع رسالة يحتوي على النص التالي:

Name: Patrick Hines

راجع أيضًا:

المرجع

استيراد عبارات (مساحة الاسم XML)

موارد أخرى

الوصول إلى XML في Visual Basic