Sdílet prostřednictvím

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

  • Článek

Importuje předpony oboru názvů XML pro použití v literálech XML a vlastnostech osy XML.

Syntaxe

Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">

Součástky

xmlNamespacePrefix
Nepovinné. Řetězec, podle kterého mohou elementy a atributy XML odkazovat xmlNamespaceName. Pokud není zadán žádný xmlNamespacePrefix , importovaný obor názvů XML je výchozím oborem názvů XML. Musí to být platný identifikátor XML. Další informace naleznete v tématu Názvy deklarovaných elementů XML a atributů.

xmlNamespaceName
Povinný: Řetězec identifikující importovaný obor názvů XML.

Poznámky

Příkaz můžete použít Imports k definování globálních oborů názvů XML, které můžete použít s literály XML a vlastnostmi osy XML nebo jako parametry předané operátoru GetXmlNamespace . (Informace o použití příkazu k importu Imports aliasu, který se dá použít, kde se v kódu používají názvy typů, najdete v tématu Import – příkaz (obor názvů a typ .NET).) Syntaxe pro deklarování oboru názvů XML pomocí Imports příkazu je shodná se syntaxí použitou v jazyce XML. Proto můžete zkopírovat deklaraci oboru názvů ze souboru XML a použít ji v Imports příkazu.

Předpony oboru názvů XML jsou užitečné, když chcete opakovaně vytvářet elementy XML, které jsou ze stejného oboru názvů. Předpona oboru názvů XML deklarovaná příkazem Imports je globální v tom smyslu, že je k dispozici pro veškerý kód v souboru. Můžete ho použít při vytváření literálů elementů XML a při přístupu k vlastnostem osy XML. Další informace naleznete v tématu Xml Element Literal and XML Axis Properties.

Pokud definujete globální obor názvů XML bez předpony oboru názvů (například Imports <xmlns="http://SomeNameSpace>"), tento obor názvů se považuje za výchozí obor názvů XML. Výchozí obor názvů XML se používá pro všechny literály elementů XML nebo vlastnosti osy atributů XML, které explicitně nezadávají obor názvů. Výchozí obor názvů se používá také v případě, že zadaný obor názvů je prázdný obor názvů (to znamená xmlns=""). Výchozí obor názvů XML se nevztahuje na atributy XML v literálech XML ani na vlastnosti osy atributů XML, které nemají obor názvů.

Obory názvů XML definované v literálu XML, které se nazývají místní obory názvů XML, mají přednost před obory názvů XML, které jsou definovány příkazem Imports jako globální. Obory názvů XML definované příkazem Imports mají přednost před obory názvů XML importovanými pro projekt jazyka Visual Basic. Pokud literál XML definuje obor názvů XML, tento místní obor názvů se nevztahuje na vložené výrazy.

Globální obory názvů XML se řídí stejnými pravidly oborů oborů a definic jako obory názvů rozhraní .NET Framework. V důsledku toho můžete zahrnout Imports příkaz pro definování globálního oboru názvů XML kdekoli, kde můžete importovat obor názvů rozhraní .NET Framework. To zahrnuje soubory kódu i importované obory názvů na úrovni projektu. Informace o importovaných oborech názvů na úrovni projektu naleznete v tématu Reference Page, Project Designer (Visual Basic).

Každý zdrojový soubor může obsahovat libovolný počet Imports příkazů. Tyto příkazy musí dodržovat deklarace možností, například Option Strict příkaz, a musí předcházet deklaracím programovacích prvků, jako Module jsou příkazy nebo Class příkazy.

Příklad 1

Následující příklad naimportuje výchozí obor názvů XML a obor názvů XML identifikovaný 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 zobrazí následující text:

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

Příklad 2

Následující příklad naimportuje předponu nsoboru názvů XML . Potom vytvoří literál XML, který používá předponu oboru názvů a zobrazí konečný formulář elementu.

' 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 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řevedl předponu oboru názvů XML z globální předpony na definici místní předpony.

Příklad 3

Následující příklad naimportuje předponu nsoboru názvů XML . Potom použije předponu oboru názvů k vytvoření literálu XML a přístup k prvnímu podřízeného uzlu s kvalifikovaným 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 zobrazí následující text:

Patrick Hines

Viz také