Właściwości osi atrybutu XML (Visual Basic)
Zapewnia dostęp do wartości atrybutu XElement obiektu lub do pierwszego elementu w kolekcji z XElement obiektów.
object.@attribute
-or-
object.@<attribute>
Części
object
Wymagane.XElement Obiekt lub zbiór XElement obiektów..@
Wymagane.Oznacza początek osi właściwości atrybutu.<
Opcjonalne.Oznacza początek nazwę atrybutu, gdy attribute nie jest prawidłowym identyfikatorem w Visual Basic.attribute
Wymagane.Nazwa atrybutu do dostępu w formularzu prefix:]name.Część
Opis
prefix
Opcjonalne.Prefiks obszaru nazw XML dla atrybutu.Musi być globalnej przestrzeni nazw XML zdefiniowana z Imports instrukcji.
name
Wymagane.Nazwa atrybutu lokalnego.See Nazwy deklarowanych elementów XML oraz atrybuty (Visual Basic).
>
Opcjonalne.Oznacza koniec nazwę atrybutu, gdy attribute nie jest prawidłowym identyfikatorem w Visual Basic.
Wartość zwracana
Ciąg, który zawiera wartość attribute.Jeśli nazwa atrybutu nie istnieje, Nothing jest zwracany.
Uwagi
Właściwość osi atrybut XML umożliwia dostęp do wartości atrybutu nazwy z XElement obiektu lub od pierwszego elementu w kolekcji z XElement obiektów.Można pobrać wartość atrybutu nazwy lub dodać nowy atrybut do elementu, określając nową nazwę poprzedzone @ identyfikator.
Gdy odwołujesz się do atrybutu XML, przy użyciu @ identyfikator, zwracana jest wartość atrybutu, jako ciąg znaków i nie trzeba jawnie określić Value właściwości.
Zasady nazewnictwa dla atrybutów XML różnią się od reguł nazewnictwa Visual Basic identyfikatorów. Aby uzyskać dostęp do atrybutu XML, który ma nazwę, która nie jest prawidłowym identyfikatorem języka Visual Basic, nazwę ująć w nawiasy ostre (< i >).
Przestrzenie nazw XML
Nazwa właściwości osi atrybut można używać tylko nazw XML prefiksy globalnie jawnie deklarowane przy użyciu Imports instrukcji.Nie może on używać lokalnie zadeklarowana wewnątrz literały element XML prefiksy obszarów nazw XML.Aby uzyskać więcej informacji, zobacz Imports — Instrukcja (przestrzeń nazw XML).
Przykład
Poniższy przykład ilustruje sposób w celu uzyskania wartości atrybutów XML o nazwie type z kolekcji elementów XML, które są nazwane 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)
Ten kod wyświetla następujący tekst:
<phoneTypes>
<type>home</type>
<type>work</type>
</phoneTypes>
Poniższy przykład ilustruje utworzyć atrybuty elementu XML zarówno deklaratywny, jako część pliku XML i dynamicznie przez dodanie atrybutu do wystąpienia XElement obiektu.type Atrybut jest tworzony deklaratywny i owner atrybut jest tworzony dynamicznie.
Dim phone2 As XElement = <phone type="home">206-555-0144</phone>
phone2.@owner = "Harris, Phyllis"
Console.WriteLine(phone2)
Ten kod wyświetla następujący tekst:
<phone type="home" owner="Harris, Phyllis">206-555-0144</phone>
W poniższym przykładzie użyto składni nawias kątowy do uzyskania wartości atrybutu XML o nazwie number-type, który nie jest prawidłowym identyfikatorem w Visual Basic.
Dim phone As XElement =
<phone number-type=" work">425-555-0145</phone>
Console.WriteLine("Phone type: " & phone.@<number-type>)
Ten kod wyświetla następujący tekst:
Phone type: work
Poniższy przykład deklaruje ns jako prefiks obszaru nazw XML.Następnie używa prefiks obszaru nazw do tworzenia literał XML i uzyskiwania dostępu pierwszego węzła podrzędnego o nazwie kwalifikowanej "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
Ten kod wyświetla następujący tekst:
Phone type: home
Zobacz też
Informacje
Koncepcje
Nazwy deklarowanych elementów XML oraz atrybuty (Visual Basic)