Proprietà axis descendant XML (Visual Basic)
Fornisce l'accesso ai discendenti di uno dei seguenti oggetti: oggetto XElement, oggetto XDocument, insieme di oggetti XElement, insieme di oggetti XDocument.
object...<descendant>
Parti
object
Obbligatorio. Un oggetto XElement, un oggetto XDocument, un insieme di oggetti XElement o un insieme di oggetti XDocument...<
Obbligatorio. Indica l'inizio di una proprietà axis descendant.descendant
Obbligatorio. Nome dei nodi discendenti a cui accedere, nel formato [prefix:]name.Parte
Descrizione
prefix
Facoltativo. Prefisso dello spazio dei nomi XML per il nodo discendente. Deve essere un spazio dei nomi XML globale definito utilizzando un'istruzione Imports.
name
Obbligatorio. Nome locale del nodo discendente. Vedere Nomi di elementi e attributi XML dichiarati (Visual Basic).
>
Obbligatoria. Indica la fine di una proprietà axis descendant.
Valore restituito
Insieme di oggetti XElement.
Note
È possibile utilizzare una proprietà axis descendant XML per accedere a nodi discendenti in base al nome, da un oggetto XElement o da un oggetto XDocument o da insiemi di oggetti XElement o XDocument. Utilizzare la proprietà Value per accedere al valore del primo nodo discendente nell'insieme restituito. Per ulteriori informazioni, vedere Proprietà Value XML (Visual Basic).
Il compilatore Visual Basic converte le proprietà axis discendenti in chiamate al metodo Descendants.
Spazi dei nomi XML
Il nome in una proprietà axis descendant può utilizzare solo spazi dei nomi XML dichiarati globalmente con l'istruzione Imports. Non può utilizzare 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 accedere al valore del primo nodo discendente denominato name e ai valori di tutti i nodi discendenti denominati phone dall'oggetto contacts.
Dim contacts As XElement =
<contacts>
<contact>
<name>Patrick Hines</name>
<phone type="home">206-555-0144</phone>
<phone type="work">425-555-0145</phone>
</contact>
</contacts>
Console.WriteLine("Name: " & contacts...<name>.Value)
Dim homePhone = From phone In contacts...<phone>
Select phone.Value
Console.WriteLine("Home Phone = {0}", homePhone(0))
Verrà visualizzato il seguente testo:
Name: Patrick Hines
Home Phone = 206-555-0144
Nell'esempio riportato di seguito viene dichiarato ns come un prefisso dello spazio dei nomi XML. Viene utilizzato quindi il prefisso dello spazio dei nomi per creare un valore letterale XML e accedere al valore del primo nodo figlio con il nome completo ns:name.
Imports <xmlns:ns = "http://SomeNamespace">
Class TestClass2
Shared Sub TestPrefix()
Dim contacts =
<ns:contacts>
<ns:contact>
<ns:name>Patrick Hines</ns:name>
</ns:contact>
</ns:contacts>
Console.WriteLine("Name: " & contacts...<ns:name>.Value)
End Sub
End Class
Verrà visualizzato il seguente testo:
Name: Patrick Hines
Vedere anche
Riferimenti
Concetti
Nomi di elementi e attributi XML dichiarati (Visual Basic)
Altre risorse
Proprietà Axis XML (Visual Basic)