Sdílet prostřednictvím

Vlastnost osy atributu XML (Visual Basic)

  • Článek

Poskytuje přístup k hodnotě atributu pro XElement objekt nebo k prvnímu prvku v kolekci XElement objektů.

Syntaxe

object.@attribute
' -or-
object.@<attribute>

Součástky

object Požadované. Objekt XElement nebo kolekce XElement objektů.

.@ Povinný argument. Označuje začátek vlastnosti osy atributů.

< Volitelné. Označuje začátek názvu atributu, pokud attribute není platný identifikátor v jazyce Visual Basic.

attribute Požadované. Název atributu pro přístup ve formuláři [prefix:]name.

Část Popis
prefix Nepovinné. Předpona oboru názvů XML pro atribut Musí to být globální obor názvů XML definovaný příkazem Imports .
name Povinný: Název místního atributu Viz názvy deklarovaných elementů a atributů XML.

> Volitelné. Označuje konec názvu atributu, pokud attribute není platný identifikátor v jazyce Visual Basic.

Návratová hodnota

Řetězec, který obsahuje hodnotu attribute. Pokud název atributu neexistuje, Nothing vrátí se.

Poznámky

Vlastnost osy atributů XML můžete použít pro přístup k hodnotě atributu podle názvu z objektu XElement nebo z prvního prvku v kolekci XElement objektů. Hodnotu atributu můžete načíst podle názvu nebo přidat nový atribut do elementu zadáním nového názvu před identifikátorem @.

Pokud odkazujete na atribut XML pomocí identifikátoru @, vrátí se hodnota atributu jako řetězec a není nutné explicitně zadat Value vlastnost.

Pravidla pojmenování atributů XML se liší od pravidel pojmenování pro identifikátory jazyka Visual Basic. Přístup k atributu XML, který má název, který není platným identifikátorem jazyka Visual Basic, uzavřete název do úhlových závorek (< a >).

Obory názvů XML

Název vlastnosti osy atributu může používat pouze předpony oboru názvů XML deklarované globálně pomocí Imports příkazu. Nelze použít předpony oboru názvů XML deklarované místně v literálech elementů XML. Další informace naleznete v tématu Import – příkaz (obor názvů XML).

Příklad 1

Následující příklad ukazuje, jak získat hodnoty atributů XML pojmenovaných type z kolekce elementů XML, které jsou pojmenovány phone.

' Topic: XML Attribute Axis Property
Dim phones As XElement = 
    <phones>
        <phone type="home">206-555-0144</phone>
        <phone type="work">425-555-0145</phone>
    </phones>

Dim phoneTypes As XElement = 
  <phoneTypes>
      <%= From phone In phones.<phone> 
          Select <type><%= phone.@type %></type> 
      %>
  </phoneTypes>

Console.WriteLine(phoneTypes)

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

<phoneTypes>

<type>home</type>

<type>work</type>

</phoneTypes>

Příklad 2

Následující příklad ukazuje, jak vytvořit atributy pro element XML deklarativní, jako součást XML, a dynamicky přidáním atributu do instance objektu XElement . Atribut type je vytvořen deklarativním způsobem a owner atribut je vytvořen dynamicky.

Dim phone2 As XElement = <phone type="home">206-555-0144</phone>
phone2.@owner = "Harris, Phyllis"

Console.WriteLine(phone2)

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

<phone type="home" owner="Harris, Phyllis">206-555-0144</phone>

Příklad 3

Následující příklad používá syntaxi úhlové závorky k získání hodnoty atributu XML s názvem number-type, což není platný identifikátor v jazyce Visual Basic.

Dim phone As XElement = 
     <phone number-type=" work">425-555-0145</phone>

 Console.WriteLine("Phone type: " & phone.@<number-type>)

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

Phone type: work

Příklad 4

Následující příklad deklaruje ns jako předponu oboru 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 TestClass3

    Shared Sub TestPrefix()
        Dim phone = 
            <ns:phone ns:type="home">206-555-0144</ns:phone>

        Console.WriteLine("Phone type: " & phone.@ns:type)
    End Sub

End Class

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

Phone type: home

Viz také