Proprietà Child Axis XML (Visual Basic)

Fornisce l'accesso agli elementi figlio di uno dei seguenti oggetti: oggetto XElement, oggetto XDocument, raccolta di oggetti XElement, raccolta di oggetti XDocument.

object.<child>

Parti

Termine	Definizione
object	Obbligatorio. Un oggetto XElement, un oggetto XDocument, una raccolta di oggetti XElement o una raccolta di oggetti XDocument
.<	Obbligatorio. Indica l'inizio di una proprietà axis dell'elemento figlio.
child	Obbligatorio. Nome dei nodi figlio a cui accedere, nel formato [prefix:]name. Parte Descrizione prefix Parametro facoltativo. Prefisso dello spazio dei nomi XML per il nodo figlio. Deve essere uno spazio dei nomi XML globale definito utilizzando un'istruzione Imports. name Obbligatorio. Nome del nodo figlio locale. Vedere Nomi di elementi e attributi XML dichiarati (Visual Basic).
>	Obbligatorio. Indica la fine di una proprietà axis dell'elemento figlio.

Valore restituito

Raccolta di oggetti XElement.

Note

È possibile utilizzare una proprietà axis dell'elemento figlio XML per accedere a nodi figlio in base al nome, da un oggetto XElement o da un oggetto XDocument o da raccolte di oggetti XElement o XDocument. Utilizzare la proprietà Value XML per accedere al valore del primo nodo figlio nella raccolta restituito. Per ulteriori informazioni, vedere Proprietà Value XML (Visual Basic).

Il compilatore Visual Basic converte le proprietà axis dell'elemento figlio in chiamate al metodo Elements.

Spazi dei nomi XML

Il nome in una proprietà axis dell'elemento figlio può utilizzare solo prefissi 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 riportato di seguito viene illustrato come accedere ai nodi figlio denominati phone dall'oggetto contact.

Dim contact As XElement = 
    <contact>
        <name>Patrick Hines</name>
        <phone type="home">206-555-0144</phone>
        <phone type="work">425-555-0145</phone>
    </contact>

Dim homePhone = From hp In contact.<phone> 
                Where contact.<phone>.@type = "home"  
                Select hp

Console.WriteLine("Home Phone = {0}", homePhone(0).Value)

Verrà visualizzato il seguente testo:

Home Phone = 206-555-0144

Nell'esempio seguente viene mostrato come accedere ai nodi figlio denominati phone dalla raccolta restituita dalla proprietà axis dell'elemento figlio contact dell'oggetto contacts.

Dim contacts As XElement = 
    <contacts>
        <contact>
            <name>Patrick Hines</name>
            <phone type="home">206-555-0144</phone>
        </contact>
        <contact>
            <name>Lance Tucker</name>
            <phone type="work">425-555-0145</phone>
        </contact>
    </contacts>

Dim homePhone = From contact In contacts.<contact> 
                Where contact.<phone>.@type = "home"  
                Select contact.<phone>

Console.WriteLine("Home Phone = {0}", homePhone(0).Value)

Verrà visualizzato il seguente testo:

Home Phone = 206-555-0144

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 TestClass4

    Shared Sub TestPrefix()
        Dim contact = <ns:contact>
                        <ns:name>Patrick Hines</ns:name>
                      </ns:contact>
        Console.WriteLine(contact.<ns:name>.Value)
    End Sub 

End Class

Verrà visualizzato il seguente testo:

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