Imports — Instrukcja (przestrzeń nazw XML)
Przywóz prefiksy obszarów nazw XML do użycia w literały XML i właściwości osi XML.
Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">
Części
xmlNamespacePrefix
Opcjonalne.Ciąg, przez które XML elementów i atrybutów może odnosić się do xmlNamespaceName.Jeśli nie xmlNamespacePrefix jest dostarczane, zaimportowanego obszaru nazw XML jest domyślny obszar nazw XML.Musi być prawidłowym identyfikatorem XML.Aby uzyskać więcej informacji, zobacz Nazwy deklarowanych elementów XML oraz atrybuty (Visual Basic).xmlNamespaceName
Wymagane.Ciąg znaków identyfikujący obszar nazw XML są przywożone.
Uwagi
Można użyć Imports instrukcji zdefiniowanie globalnej przestrzeni nazw XML, korzystające z literały XML i właściwości osi XML lub jako parametry przekazane do GetXmlNamespace operatora.(Aby uzyskać informacje dotyczące korzystania z Imports instrukcji, aby zaimportować aliasu, które mogą być używane, gdy nazwy typu są używane w kodzie, zobacz Imports — Instrukcja (.NET Namespace i Type).) Składnia deklaracji przestrzeni nazw XML za pomocą Imports instrukcja jest taka sama, jak składnia XML.W związku z tym, można skopiować deklaracja obszaru nazw z pliku XML i używać go w Imports instrukcji.
Prefiksy obszarów nazw XML są przydatne do tworzenia wielokrotnie elementy XML, które pochodzą z tej samej przestrzeni nazw.Prefiks obszaru nazw XML zadeklarowana z Imports instrukcja jest globalne w tym sensie, że jest dostępna dla całego kodu w pliku.Można go użyć podczas tworzenia literałów element XML i podczas uzyskiwania dostępu właściwości osi XML.Aby uzyskać więcej informacji, zobacz Literał elementu XML (Visual Basic) i Właściwości osi XML (Visual Basic).
Jeśli możesz zdefiniować globalnej przestrzeni nazw XML bez prefiks obszaru nazw (na przykład, Imports <xmlns="http://SomeNameSpace>"), tego obszaru nazw jest uważany za domyślny obszar nazw XML.Domyślny obszar nazw XML jest używany dla literały element XML lub atrybut osi właściwości XML, które wyraźnie nie określono obszaru nazw.Domyślny obszar nazw jest też używana, jeśli określony obszar nazw jest pusty obszar nazw (to znaczy ).Domyślny obszar nazw XML nie stosuje się do atrybutów XML w literały XML lub atrybut osi właściwości XML, które nie ma obszaru nazw.
Przestrzeni nazw XML są zdefiniowane w XML literału, które są nazywane lokalnych obszarów nazw XML, pierwszeństwo przestrzeni nazw XML, które są zdefiniowane przez Imports instrukcji ogólnych.Przestrzenie nazw XML, które są definiowane przez Imports instrukcji mają pierwszeństwo przed importowane do programu Visual Basic project przestrzeni nazw XML.Literał XML definiuje przestrzeni nazw XML, że lokalnego obszaru nazw nie stosuje się do wyrażenia osadzone.
Globalnej przestrzeni nazw XML, należy wykonać te same zakresy i definicji reguły.NET Framework obszarów nazw.W efekcie może zawierać Imports instrukcji zdefiniowanie globalnej przestrzeni nazw XML, gdziekolwiek można importować.NET Framework obszaru nazw.Obejmuje to zarówno pliki kodu i poziomie projektu importowane obszary nazw.Informacje o poziomie projektu importowane obszary nazw, zobacz Strona odwołań, Projektant projektu (Visual Basic).
Każdy plik źródłowy może zawierać dowolną liczbę Imports instrukcji.Te należy wykonać deklaracje opcji, takich jak Option Strict instrukcji i one musi poprzedzać deklaracji elementu programowania, takich jak Module lub Class instrukcji.
Przykład
Poniższy przykład importuje domyślny obszar nazw XML i przestrzeni nazw XML, identyfikowane z prefiksem ns.Następnie tworzy literały XML, używających obu obszarach nazw.
' 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
Ten kod wyświetla następujący tekst:
<ns:outer xmlns="http://DefaultNamespace"
xmlns:ns="http://NewNamespace">
<ns:innerElement></ns:innerElement>
<siblingElement></siblingElement>
<innerElement />
</ns:outer>
Poniższy przykład importuje prefiks obszaru nazw XML ns.Następnie tworzy literał XML, wykorzystująca prefiks obszaru nazw i wyświetla element ostatecznej postaci.
' 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
Ten kod wyświetla następujący tekst:
<ns:outer xmlns:ns="http://SomeNamespace">
<ns:middle xmlns:ns="http://NewNamespace">
<ns:inner1 />
<inner2 xmlns="http://SomeNamespace" />
</ns:middle>
</ns:outer>
Zawiadomienie o kompilator konwertowane prefiks obszaru nazw XML z prefiks globalny definicji prefiksu lokalnego.
Poniższy przykład importuje prefiks obszaru nazw XML ns.Następnie używa prefiks obszaru nazw do tworzenia literał XML i uzyskiwania dostępu pierwszego węzła podrzędnego o nazwie kwalifikowanej 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
Ten kod wyświetla następujący tekst:
Patrick Hines
Zobacz też
Informacje
Literał elementu XML (Visual Basic)
GetXmlNamespace — Operator (Visual Basic)
Koncepcje
Nazwy deklarowanych elementów XML oraz atrybuty (Visual Basic)