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 .
Syntax
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.
< Választható. 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észe | 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. |
> Választható. Az attribútum nevének végét jelzi, ha attribute
nem érvényes azonosító a Visual Basicben.
Visszatérési érték
Egy sztring, amely a következő értéket attribute
tartalmazza: . 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-type
XML-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