Sdílet prostřednictvím

Imports – Příkaz (obor názvů XML)

  • Článek

Importuje předpony oborů názvů XML pro použití v XML literály a vlastnosti XML osy.

Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">

Části

  • xmlNamespacePrefix
    Nepovinné.Řetězec XML, které prvky a atributy mohou odkazovat na xmlNamespaceName.Pokud ne xmlNamespacePrefix je zadán, importované obor názvů XML je výchozí obor názvů XML.Musí být platný identifikátor XML.Další informace naleznete v tématu Názvy deklarovaných XML elementů a atributů (Visual Basic).

  • xmlNamespaceName
    Povinné.Řetězec určující obor názvů XML, které jsou dováženy.

Poznámky

Můžete použít Imports příkaz definovat globální jmenných prostorů XML, který lze použít s literály XML a vlastnosti XML osy nebo jako parametry předané GetXmlNamespace operátor.(Informace o použití Imports příkaz Import alias, který lze použít při použití názvů typu v kódu, viz Imports – příkaz (obor názvů a typ rozhraní .NET).) Syntaxe pro deklarování jmenný prostor XML pomocí Imports prohlášení je stejná jako syntaxe používané v jazyce XML.Proto můžete zkopírovat soubor XML deklarace oboru názvů a jeho použití v Imports prohlášení.

Předpony oborů názvů XML jsou užitečné, pokud chcete vytvořit opakovaně elementy XML, které jsou z stejný obor názvů.Předpona oboru názvů XML deklarována s Imports prohlášení je globální v tom smyslu, že je k dispozici pro veškerý kód v souboru.Můžete jej při vytváření literály prvek XML a při přístupu k vlastnosti XML osy.Další informace naleznete v tématu Literál XML elementu (Visual Basic) a Vlastnosti osy XML (Visual Basic).

Pokud definujete globální obor názvů XML bez prefix oboru názvů (například Imports <xmlns="http://SomeNameSpace>"), tento obor názvů je považována za výchozí obor názvů XML.Výchozí obor názvů XML slouží pro literály prvek XML nebo vlastností osy atributu XML, které nejsou explicitně zadat obor názvů.Pokud zadaný obor názvů je prázdný obor názvů se také používá výchozí obor názvů (, ).Výchozí obor názvů XML nelze použít atributy XML v XML literály nebo osy vlastnosti atributu XML, které nemají oboru názvů.

Jmenných prostorů XML, které jsou definovány v XML literálu, který se nazývá místní obory názvů XML, přednost obory názvů XML, které jsou definovány Imports prohlášení jako globální.Obory názvů XML, které jsou definovány Imports prohlášení přednost jmenných prostorů XML importován pro projekt aplikace Visual Basic.Pokud literál XML definuje jmenný prostor XML, že místní obor názvů se nevztahuje na vložené výrazy.

Globální obory názvů XML stejným pravidlům oborů a definice jako.NET Framework obory názvů.Proto můžete zahrnout Imports příkaz definovat globální obor názvů XML kamkoli můžete importovat.NET Framework oboru názvů.Zahrnuje soubory kódu a obory názvů importované projektu.Informace o projektu importované obory, viz Stránka Odkazy, návrhář projektu (Visual Basic).

Každý zdrojový soubor může obsahovat libovolný počet Imports příkazy.Tyto postupujte možnost prohlášení Option Strict prohlášení a jejich musí předcházet programování deklarace prvků, jako například Module nebo Class příkazy.

Příklad

V následujícím příkladu importuje výchozí obor názvů XML a obor názvů XML s předponou ns.Potom vytvoří literály XML, které používají oba obory názvů.

' 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

Tento kód se zobrazí následující text:

<ns:outer xmlns="http://DefaultNamespace" 
          xmlns:ns="http://NewNamespace">
  <ns:innerElement></ns:innerElement>
  <siblingElement></siblingElement>
  <innerElement />
</ns:outer>

V následujícím příkladu importuje prefix oboru názvů XML ns.Potom vytvoří literál XML používá předponu oboru názvů a konečné podobě prvku zobrazí.

' 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

Tento kód se zobrazí následující text:

<ns:outer xmlns:ns="http://SomeNamespace">
  <ns:middle xmlns:ns="http://NewNamespace">
    <ns:inner1 />
    <inner2 xmlns="http://SomeNamespace" />
  </ns:middle>
</ns:outer>

Všimněte si, že kompilátor převést prefix oboru názvů XML z globální předponu místní předpony definice.

V následujícím příkladu importuje prefix oboru názvů XML ns.Poté použije prefix oboru názvů vytvořit literál XML a přistupovat k první podřízený uzel s názvem 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

Tento kód se zobrazí následující text:

Patrick Hines

Viz také

Referenční dokumentace

Literál XML elementu (Visual Basic)

GetXmlNamespace – operátor (Visual Basic)

Koncepty

Názvy deklarovaných XML elementů a atributů (Visual Basic)

Další zdroje

Vlastnosti osy XML (Visual Basic)