Proprietà axis dell'attributo XML (Visual Basic)
Fornisce accesso al valore di un attributo per un oggetto XElement o al primo elemento in una raccolta di oggetti XElement.
object.@attribute
-or-
object.@<attribute>
Parti
object
Obbligatorio. Un oggetto XElement o una raccolta di oggetti XElement..@
Obbligatorio. Indica l'inizio di una proprietà axis attributo.<
Parametro facoltativo. Indica l'inizio del nome dell'attributo quando attribute non è un identificatore valido in Visual Basic.attribute
Obbligatorio. Nome dell'attributo a cui accedere, nel formato [prefix]name.Parte
Descrizione
prefix
Parametro facoltativo. Prefisso dello spazio dei nomi XML per l'attributo. Deve essere uno spazio dei nomi XML globale definito utilizzando un'istruzione Imports.
name
Obbligatorio. Nome di attributo locale Vedere Nomi di elementi e attributi XML dichiarati (Visual Basic).
>
Parametro facoltativo. Indica la fine del nome di attributo quando attribute non è un identificatore valido in Visual Basic.
Valore restituito
Stringa contenente il valore di attribute. Se il nome dell'attributo non esiste, viene restituito Nothing.
Note
È possibile utilizzare una proprietà axis di un attributo XML per accedere al valore di un attributo in base al nome da un oggetto XElement o dal primo elemento in una raccolta di oggetti XElement. È possibile recuperare un valore dell'attributo in base al nome o aggiungere un nuovo attributo a un elemento specificando un nuovo nome preceduto dall'identificatore @.
Quando viene fatto riferimento a un attributo XML utilizzando l'identificatore @, il valore dell'attributo viene restituito come una stringa e non è necessario specificare in modo esplicito la proprietà Value.
Le regole di denominazione per gli attributi XML differiscono dalle regole di denominazione per gli identificatori di Visual Basic. Per accedere a un attributo XML con un nome che non è un identificatore di Visual Basic valido, racchiudere il nome tra parentesi acute (< e >).
Spazi dei nomi XML
Il nome in una proprietà axis attributo può utilizzare solo prefisso degli spazi dei nomi XML dichiarati globalmente con l'istruzione Imports. Non può utilizzare prefissi degli spazi dei nomi XML dichiarati localmente all'interno di valori letterali dell'elemento XML. Per ulteriori informazioni, vedere Istruzione Imports (spazio dei nomi XML).
Esempio
Nell'esempio seguente viene mostrato come ottenere i valori degli attributi XML denominati type da una raccolta di elementi XML denominati 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)
Verrà visualizzato il seguente testo:
<phoneTypes>
<type>home</type>
<type>work</type>
</phoneTypes>
Nell'esempio seguente viene illustrato come creare attributi per un elemento XML, sia in modo dichiarativo come parte dell'XML che dinamicamente aggiungendo un attributo a un'istanza di un oggetto XElement. L'attributo di type viene creato in modo dichiarativo e l'attributo owne viene creato dinamicamente.
Dim phone2 As XElement = <phone type="home">206-555-0144</phone>
phone2.@owner = "Harris, Phyllis"
Console.WriteLine(phone2)
Verrà visualizzato il seguente testo:
<phone type="home" owner="Harris, Phyllis">206-555-0144</phone>
Nell'esempio seguente viene utilizzata la sintassi della parentesi angolari per ottenere il valore dell'attributo XML denominato number-type, che non è un identificatore valido in Visual Basic.
Dim phone As XElement =
<phone number-type=" work">425-555-0145</phone>
Console.WriteLine("Phone type: " & phone.@<number-type>)
Verrà visualizzato il seguente testo:
Phone type: work
Nell'esempio riportato di seguito viene dichiarato ns come un prefisso dello spazio dei nomi XML. Viene quindi utilizzato il prefisso dello spazio dei nomi per creare un valore letterale XML e accedere al primo nodo figlio con il nome completo "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
Verrà visualizzato il seguente testo:
Phone type: home
Vedere anche
Riferimenti
Concetti
Nomi di elementi e attributi XML dichiarati (Visual Basic)
Altre risorse
Proprietà Axis XML (Visual Basic)