Udostępnij za pośrednictwem

Właściwości osi atrybutu XML (Visual Basic)

  • Artykuł

Zapewnia dostęp do wartości atrybutu dla XElement obiektu lub pierwszego elementu w kolekcji XElement obiektów.

Składnia

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

generatora

object Wymagane. XElement Obiekt lub kolekcja XElement obiektów.

.@ Wymagane. Określa początek właściwości osi atrybutu.

< Opcjonalne. Określa początek nazwy atrybutu, gdy attribute nie jest prawidłowym identyfikatorem w Visual Basic.

attribute Wymagane. Nazwa atrybutu dostępu do formularza [prefix:]name.

Element opis
prefix Opcjonalny. Prefiks przestrzeni nazw XML dla atrybutu. Musi być globalną przestrzenią nazw XML zdefiniowaną za pomocą instrukcji Imports .
name Wymagany. Nazwa atrybutu lokalnego. Zobacz Nazwy zadeklarowanych elementów XML i atrybutów.

> Opcjonalne. Określa koniec nazwy atrybutu, gdy attribute nie jest prawidłowym identyfikatorem w Visual Basic.

Wartość zwracana

Ciąg zawierający wartość attribute. Jeśli nazwa atrybutu nie istnieje, Nothing zostanie zwrócona.

Uwagi

Za pomocą właściwości osi atrybutu XML można uzyskać dostęp do wartości atrybutu według nazwy z XElement obiektu lub z pierwszego elementu w kolekcji XElement obiektów. Wartość atrybutu można pobrać według nazwy lub dodać nowy atrybut do elementu, określając nową nazwę poprzedzoną identyfikatorem @.

W przypadku odwoływania się do atrybutu XML przy użyciu identyfikatora @ wartość atrybutu jest zwracana jako ciąg i nie trzeba jawnie określać Value właściwości.

Reguły nazewnictwa atrybutów XML różnią się od reguł nazewnictwa identyfikatorów języka Visual Basic. Aby uzyskać dostęp do atrybutu XML, który ma nazwę, która nie jest prawidłowym identyfikatorem języka Visual Basic, należy ująć nazwę w nawiasy kątowe (< i >).

Przestrzenie nazw XML

Nazwa we właściwości osi atrybutu może używać tylko prefiksów przestrzeni nazw XML zadeklarowanych globalnie przy użyciu instrukcji Imports . Nie może używać prefiksów przestrzeni nazw XML zadeklarowanych lokalnie w literałach elementu XML. Aby uzyskać więcej informacji, zobacz Import Statement (XML Namespace).

Przykład 1

W poniższym przykładzie pokazano, jak pobrać wartości atrybutów XML o nazwie type z kolekcji elementów XML o nazwie 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>

Przykład 2

W poniższym przykładzie pokazano, jak utworzyć atrybuty dla elementu XML zarówno deklaratywnie, jak i w ramach kodu XML, i dynamicznie przez dodanie atrybutu XElement do wystąpienia obiektu. Atrybut type jest tworzony deklaratywnie, a 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>

Przykład 3

W poniższym przykładzie użyto składni nawiasu kątowego, aby uzyskać wartość atrybutu XML o nazwie number-type, który nie jest prawidłowym identyfikatorem w języku 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

Przykład 4

Poniższy przykład deklaruje ns jako prefiks przestrzeni nazw XML. Następnie używa prefiksu przestrzeni nazw, aby utworzyć literał XML i uzyskać dostęp do pierwszego węzła podrzędnego o kwalifikowanej nazwie "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ż