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

  • Článek
  • 2 min ke čtení

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

Syntax

Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">

Součásti

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

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

Poznámky

Příkaz můžete použít k definování globálních oborů názvů XML, které můžete použít s literály XML a vlastnosti osy XML, nebo jako parametry předané Imports GetXmlNamespace operátoru. (Informace o použití příkazu k importu aliasu, který lze použít tam, kde se ve vašem kódu používají názvy typů, najdete v tématu Příkaz Imports (obor názvů a Imports typ .NET). Syntaxe pro deklarování oboru názvů XML pomocí příkazu je stejná jako Imports syntaxe použitá v 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 je globální v tom smyslu, že je k dispozici pro veškerý Imports kód v souboru. Můžete ji použít při vytváření literálů elementu XML a při přístupu k vlastnostem osy XML. Další informace najdete v tématu Literál elementu XML a Vlastnosti osy XML.

Pokud definujete globální obor názvů XML bez předpony oboru názvů (například ), je tento obor názvů Imports <xmlns="http://SomeNameSpace>" považován za výchozí obor názvů XML. Výchozí obor názvů XML se používá pro všechny literály elementu XML nebo vlastnosti osy atributu XML, které explicitně nezadá 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 nebo na vlastnosti osy atributu XML, které nemají obor názvů.

Obory názvů XML, které jsou definovány 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 Imports příkazem jako globální. Obory názvů XML definované příkazem mají přednost před obory názvů XML importované pro Imports Visual Basic projektu. 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 řídit stejnými pravidly oboru a definice jako .NET Framework obory názvů. V důsledku toho můžete zahrnout příkaz pro definování globálního oboru názvů XML kdekoli můžete importovat .NET Framework Imports oboru názvů. To zahrnuje jak soubory kódu, tak importované obory názvů na úrovni projektu. Informace o importovaných oborech názvů na úrovni projektu najdete na stránce Odkazy v návrháři Project (Visual Basic).

Každý zdrojový soubor může obsahovat libovolný počet Imports příkazů. Musí se řídit deklaracemi možností, jako je příkaz , a musí předcházet deklaraci programovacích Option Strict elementů, jako jsou příkazy nebo Module Class .

Příklad 1

Následující příklad importuje výchozí obor názvů XML a obor názvů XML identifikované předponou ns . Pak 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 importuje předponu oboru názvů XML ns . Potom vytvoří literál XML, který používá předponu oboru názvů a zobrazí konečný tvar 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řevést 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 importuje předponu oboru názvů XML ns . Pak pomocí předpony oboru názvů vytvoří literál XML a přistupuje k prvnímu podřízenému 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é