XML-attribútumtengely tulajdonsága (Visual Basic)

Hozzáférést biztosít egy objektum vagy egy objektumgyűjtemény első eleméhez tartozó attribútum XElement értékéhez XElement .

Szemantika

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

Részek

object Szükséges. Objektum XElement vagy objektumgyűjtemény XElement .

.@ Kötelező. Egy attribútumtengely-tulajdonság kezdetét jelöli.

< nem kötelező. Az attribútum nevének kezdetét jelöli, ha attribute nem érvényes azonosító a Visual Basicben.

attribute Szükséges. A hozzáféréshez szükséges attribútum neve, az űrlap neve [prefix:]name.

Rész	Leírás
prefix	Opcionális. Az attribútum XML-névtér-előtagja. Egy utasítással definiált Imports globális XML-névtérnek kell lennie.
name	Szükséges. Helyi attribútum neve. Lásd : Deklarált XML-elemek és attribútumok neve.

> nem kötelező. Az attribútum nevének végét jelzi, ha attribute nem érvényes azonosító a Visual Basicben.

Visszaadott érték

Egy sztring, amely a következő értéket attributetartalmazza: . Ha az attribútum neve nem létezik, Nothing a függvény visszaadja.

Megjegyzések

Az XML-attribútumtengely tulajdonságával név alapján érheti el az attribútum értékét egy XElement objektumból vagy egy objektumgyűjtemény első eleméből XElement . Az attribútumértékeket lekérheti név alapján, vagy hozzáadhat egy új attribútumot egy elemhez a @ azonosító előtti új név megadásával.

Ha a @ azonosítót használó XML-attribútumra hivatkozik, az attribútum értéke sztringként lesz visszaadva, és nem kell explicit módon megadnia a tulajdonságot Value .

Az XML-attribútumok elnevezési szabályai eltérnek a Visual Basic-azonosítók elnevezési szabályaitól. Ha olyan XML-attribútumot szeretne elérni, amelynek neve nem érvényes Visual Basic-azonosító, a nevet szögletes zárójelek (< és >) közé kell tenni.

XML-névterek

Az attribútumtengely-tulajdonságban lévő név csak a globálisan deklarált XML-névtér-előtagokat használhatja az Imports utasítás használatával. Nem használhatja a helyileg deklarált XML-névtér-előtagokat az XML-elemkonstansokban. További információ: Import Statement (XML Namespace).

1. példa

Az alábbi példa bemutatja, hogyan szerezheti be a névvel ellátott XML-elemek gyűjteményéből elnevezett type XML-attribútumok phoneértékeit.

' 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)

Ez a kód a következő szöveget jeleníti meg:

<phoneTypes>

<type>home</type>

<type>work</type>

</phoneTypes>

2. példa

Az alábbi példa bemutatja, hogyan hozhat létre attribútumokat egy XML-elemhez deklaratív módon, az XML részeként, és hogyan adhat hozzá egy attribútumot egy XElement objektum egy példányához. Az type attribútum deklaratív módon jön létre, és az owner attribútum dinamikusan jön létre.

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

Console.WriteLine(phone2)

Ez a kód a következő szöveget jeleníti meg:

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

3. példa

Az alábbi példa a szögletes zárójel szintaxisát használja a nevesített number-typeXML-attribútum értékének lekéréséhez, amely nem érvényes azonosító a Visual Basicben.

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

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

Ez a kód a következő szöveget jeleníti meg:

Phone type: work

4. példa

Az alábbi példa XML-névtérelőtagként deklarál ns . Ezután a névtér előtagjával létrehoz egy XML-konstanst, és hozzáfér az első gyermekcsomóponthoz a "ns:name" minősített névvel.

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

Ez a kód a következő szöveget jeleníti meg:

Phone type: home

Lásd még

• XElement
• XML-tengely tulajdonságai
• XML-literálok
• XML létrehozása a Visual Basicben
• Deklarált XML-elemek és attribútumok neve