استيراد عبارات (مساحة الاسم XML)
استيراد بادئات مساحات الأسماء XML للاستخدام في القيم الحرفية XML ومحور XML خصائص.
Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">
الأجزاء
xmlNamespacePrefix
اختياري. السلسلة بواسطة عناصر XML و سمات قد تشير إلىxmlNamespaceName. إذا لم يتم توفير xmlNamespacePrefix ، مساحة الاسم XML المستوردة هي مساحة الاسم XML الافتراضية. يجب أن يكون معرّف XML صالح. لمزيد من المعلومات، راجع أسماء عناصر XML المُعلَنة و السمات.xmlNamespaceName
مطلوبة. السلسلة تعرّف مساحة الاسم XML الذي يتم استيراده.
ملاحظات
يمكنك استخدام عبارة Imports لتعريف مساحات الاسم XML العمومية التي يمكنك استخدامها مع القيم الحرفية XML وخصائص محور XML أو كمعلمات تمرير إلى عامل تشغيل GetXmlNamespace . (للحصول على معلومات حول استخدام عبارة Imports لاستيراد الأسماء المستعارة التي يمكن استخدامها حيثما يتم استخدام أسماء النوع في التعليمات البرمجية, راجع استيراد كشف (مساحة الاسم و نوع NET.).) بناء جملة للتصريح عن مساحة الاسم XML باستخدام عبارة Imports يماثل بناء الجملة المستخدمة في XML. لذلك، يمكنك نسخ تصريح مساحة الاسم من ملف XML ثم استخدامه في عبارة Imports .
بادئات مساحات الأسماء XML مفيدة عندما تريد بشكل متكرر إنشاء عناصر XML من نفس مساحة الاسم. تم تعريف بادئة مساحة الاسم XML مع Imports جملة عمومية في إحساس يتوفر إلى كل التعليمات البرمجية في الملف. يمكنك استخدامه عند إنشاء القيم الحرفية لعنصر XML عند الوصول إلى خصائص محور XML . للمزيد من المعلومات، راجع الـقيمة ألحرفية لعنصر XML وخصائص محور الـ XML.
إذا قمت بتعريف مساحة اسم XML عمومية دون بادئة مساحة اسم (على سبيل المثال، Imports <xmlns="http://SomeNameSpace>") ، مساحة الاسم التي تعتبر مساحة اسم XML الافتراضي. يتم استخدام مساحة الاسم XML الافتراضية لأي القيم الحرفية لعنصر XML أو خصائص محور سمة XML التي لا تحدد مساحة الاسم بوضوح. مساحة الاسم الافتراضية أيضاً تستخدم إذا كانت مساحة الاسم المحددة مساحة اسم فارغة (أي، ). لا يتم تطبيق سمات XML الافتراضية في القيم الحرفية XML أو خصائص محور سمة إلى XML التي ليس لها مساحة الاسم.
مساحات XML التي تم تعريفها في XML قيمة حرفية, والتي تدعى مساحات الاسم XML محلي، تأخذ الأسبقية عبر مساحات الاسم XML التي تم تعريفها بواسطة عبارة Imports كـ عمومي. مساحات الاسم XML التي تم تعريفها بواسطة عبارة Imports تأخذ الأسبقية على مساحات الاسم XML لاستيراد مشروع Visual Basic. إذا كان حرفي XML يعرّف على مساحة اسم XML ، لا يتم تطبيق ذلك على مساحة الاسم المحلي للتعبيرات المضمنة.
مساحات الاسم XML العمومية تتبع نفس مجال وتعريف القواعد كـمساحات الأسماء في .NET Framework . ونتيجة لذلك، يمكن أن تتضمن العبارة Imports بتعريف مساحة الاسم XML العمومية في أي مكان يمكن استيراد مساحة الاسم في .NET Framework. ويتضمن ذلك كل من ملفات التعليمات البرمجية و مستوى المشروع المستوردة من مساحات الاسم . للحصول على معلومات حول مستوى المشروع المستوردة من مساحات الاسم, راجع صفحة المراجع، مصمم المشروع (Visual Basic).
يمكن أن تحتوي كل ملف المصدر على أي عدد من عبارات Imports . هذه يجب أن يتبع تعريفات اختيارية مثل عبارة Option Strict و يجب أن تسبق برمجة عنصر التعريفات ، مثل عبارات Module أو Class .
مثال
يستورد المثال التالي مساحة الاسم الافتراضية XML و مساحة الاسم XML المتعرف عليه بالبادئة ns. يقوم بإنشاء القيم الحرفية XML التي تستخدم كليهما مساحات الاسم.
' Place Imports statements at the top of your program.
Imports <xmlns="http://DefaultNamespace">
Imports <xmlns:ns="http://NewNamespace">
Module Module1
Sub Main()
' Create element by using the default global XML namespace.
Dim inner = <innerElement/>
' Create element by using both the default global XML namespace
' and the namespace identified with the "ns" prefix.
Dim outer = <ns:outer>
<ns:innerElement></ns:innerElement>
<siblingElement></siblingElement>
<%= inner %>
</ns:outer>
' Display element to see its final form.
Console.WriteLine(outer)
End Sub
End Module
هذه التعليمات البرمجية يعرض نص التالي:
<ns:outer xmlns="http://DefaultNamespace"
xmlns:ns="http://NewNamespace">
<ns:innerElement></ns:innerElement>
<siblingElement></siblingElement>
<innerElement />
</ns:outer>
بادئة مساحة الاسم XML يستورد المثال التاليns. ثم يقوم بإنشاء قيمة XML حرفية والتي تستخدم بادئة مساحة الاسم ويعرض نموذج العنصر النهائية.
' Place Imports statements at the top of your program.
Imports <xmlns:ns="http://SomeNamespace">
Class TestClass1
Shared Sub TestPrefix()
' Create test using a global XML namespace prefix.
Dim inner2 = <ns:inner2/>
Dim test =
<ns:outer>
<ns:middle xmlns:ns="http://NewNamespace">
<ns:inner1/>
<%= inner2 %>
</ns:middle>
</ns:outer>
' Display test to see its final form.
Console.WriteLine(test)
End Sub
End Class
هذه التعليمات البرمجية يعرض نص التالي:
<ns:outer xmlns:ns="http://SomeNamespace">
<ns:middle xmlns:ns="http://NewNamespace">
<ns:inner1 />
<inner2 xmlns="http://SomeNamespace" />
</ns:middle>
</ns:outer>
لاحظ أن المحول البرمجي محول بادئة مساحة الاسم XML من بادئة عمومية إلى تعريف بادئة محلي.
بادئة مساحة الاسم XML يستورد المثال التاليns. ثم تستخدم بادئة مساحة الاسم لإنشاء قيمة 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 المُعلَنة و السمات