Proprietà axis descendant XML (Visual Basic)

  • Articolo

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

XElement

Concetti

Nomi di elementi e attributi XML dichiarati (Visual Basic)

Altre risorse

Proprietà Axis XML (Visual Basic)

Valori letterali XML (Visual Basic)

Creazione di XML in Visual Basic