Import Utasítás (XML-névtér)
XML-névtér-előtagokat importál az XML-literálokban és az XML-tengely tulajdonságaiban való használatra.
Syntax
Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">
Részek
xmlNamespacePrefix
Opcionális. Az a sztring, amelyre az XML-elemek és -attribútumok hivatkozhatnak xmlNamespaceName. Ha nincs xmlNamespacePrefix megadva, az importált XML-névtér az alapértelmezett XML-névtér. Érvényes XML-azonosítónak kell lennie. További információ: Deklarált XML-elemek és attribútumok neve.
xmlNamespaceName
Szükséges. Az importált XML-névteret azonosító sztring.
Megjegyzések
Az Imports utasítással olyan globális XML-névtereket határozhat meg, amelyeket XML-literálokkal és XML-tengelytulajdonságokkal, illetve az GetXmlNamespace operátornak átadott paraméterekkel használhat. (Az utasítás olyan alias importálására való használatával Imports kapcsolatos információkért, amelyek a kódban használt típusneveket használják, tekintse meg az Import Statement (.NET-névtér és típus) című témakört.) Az XML-névtér utasítással Imports történő deklarálásának szintaxisa megegyezik az XML-ben használt szintaxissal. Ezért másolhat egy névtérdeklarációt egy XML-fájlból, és használhatja azt egy Imports utasításban.
Az XML-névtér előtagok akkor hasznosak, ha ismétlődően szeretne létrehozni olyan XML-elemeket, amelyek ugyanabból a névtérből származnak. Az utasítással Imports deklarált XML-névtér előtag globális abban az értelemben, hogy a fájl összes kódja számára elérhető. Ezt akkor használhatja, ha XML-elemkonstansokat hoz létre, és amikor hozzáfér az XML-tengely tulajdonságaihoz. További információ: XML-elem – Literál és XML-tengely tulajdonságai.
Ha névtérelőtag (például) nélkül határoz meg globális XML-névteret, Imports <xmlns="http://SomeNameSpace>"akkor a névtér lesz az alapértelmezett XML-névtér. Az alapértelmezett XML-névtér minden olyan XML-elemkonstanshoz vagy XML-attribútumtengely-tulajdonsághoz használatos, amely nem ad meg explicit módon névteret. Az alapértelmezett névtér akkor is használatos, ha a megadott névtér az üres névtér (azaz xmlns=""). Az alapértelmezett XML-névtér nem vonatkozik az XML-konstansokban lévő XML-attribútumokra, illetve a névtérrel nem rendelkező XML-attribútumtengely-tulajdonságokra.
Az XML-literálban definiált XML-névterek, amelyeket helyi XML-névtereknek neveznek, elsőbbséget élveznek az Imports utasítás által globálisként definiált XML-névtérekkel szemben. Az utasítás által definiált XML-névterek elsőbbséget élveznek a Imports Visual Basic-projekthez importált XML-névtereknél. Ha egy XML-literál xml-névteret határoz meg, az a helyi névtér nem vonatkozik a beágyazott kifejezésekre.
A globális XML-névterek ugyanazokat a hatókörkezelési és definíciós szabályokat követik, mint .NET-keretrendszer névterek. Ennek eredményeképpen olyan utasítást Imports is megadhat, ahová importálhat egy .NET-keretrendszer névteret, ahol globális XML-névteret definiálhat. Ide tartoznak a kódfájlok és a projektszintű importált névterek is. A projektszintű importált névterekről további információt a Hivatkozások lap, a Project Tervező (Visual Basic) című témakörben talál.
Minden forrásfájl tetszőleges számú utasítást Imports tartalmazhat. Ezeknek a beállítási deklarációkat kell követniük, például az Option Strict utasítást, és meg kell előzniük a programelem-deklarációkat, például Module vagy Class utasításokat.
1. példa
Az alábbi példa egy alapértelmezett XML-névteret és egy, az előtaggal nsazonosított XML-névteret importál. Ezután létrehoz egy XML-literálokat, amelyek mindkét névteret használják.
' 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
Ez a kód a következő szöveget jeleníti meg:
<ns:outer xmlns="http://DefaultNamespace"
xmlns:ns="http://NewNamespace">
<ns:innerElement></ns:innerElement>
<siblingElement></siblingElement>
<innerElement />
</ns:outer>
2. példa
Az alábbi példa importálja az XML-névtér előtagot ns. Ezután létrehoz egy XML-literált, amely a névtér előtagját használja, és megjeleníti az elem végleges űrlapját.
' 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
Ez a kód a következő szöveget jeleníti meg:
<ns:outer xmlns:ns="http://SomeNamespace">
<ns:middle xmlns:ns="http://NewNamespace">
<ns:inner1 />
<inner2 xmlns="http://SomeNamespace" />
</ns:middle>
</ns:outer>
Figyelje meg, hogy a fordító globális előtagból helyi előtagdefinícióvá konvertálta az XML-névtér előtagját.
3. példa
Az alábbi példa importálja az XML-névtér előtagot ns. Ezután a névtér előtagjával létrehoz egy XML-konstanst, és hozzáfér az első gyermekcsomóponthoz a minősített névvel 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
Ez a kód a következő szöveget jeleníti meg:
Patrick Hines
