Proprietà Child Axis XML (Visual Basic)

  • Articolo

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

Sintassi

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.

- Prefix - Facoltativo. Prefisso dello spazio dei nomi XML per il nodo figlio. Deve essere uno spazio dei nomi XML globale definito usando un'istruzione Imports.
- Name - Obbligatorio. Nome del nodo figlio locale. Vedere nomi di elementi e attributi XML dichiarati.
> Obbligatorio. Indica la fine di una proprietà axis dell'elemento figlio.

Valore restituito

Una raccolta di oggetti XElement.

Osservazioni:

È possibile usare una proprietà axis dell'elemento figlio XML per accedere a nodi figlio in base al nome, da un oggetto XElement o XDocument o da raccolte di oggetti XElement o XDocument. Usare la proprietà Value XML per accedere al valore del primo nodo figlio nella raccolta restituita. Per altre informazioni, vedere Proprietà Value XML.

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

Spazi dei nomi XML

Il nome in una proprietà axis dell'elemento figlio può usare solo prefissi degli spazi dei nomi XML dichiarati globalmente con l'istruzione Imports. Non può usare prefissi degli spazi dei nomi XML dichiarati localmente all'interno di valori letterali dell'elemento XML. Per altre informazioni, vedere Istruzione Imports (spazio dei nomi XML).

Esempio 1

L'esempio seguente illustra 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)

Questo codice visualizza il testo seguente:

Home Phone = 206-555-0144

Esempio 2

L'esempio seguente illustra 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)

Questo codice visualizza il testo seguente:

Home Phone = 206-555-0144

Esempio 3

Nell'esempio seguente viene dichiarato ns come un prefisso dello spazio dei nomi XML. Il prefisso dello spazio dei nomi viene quindi usato 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

Questo codice visualizza il testo seguente:

Patrick Hines

Vedi anche