Share via

Eigenschap xml-afstammelingsas (Visual Basic)

  • Artikel

Biedt toegang tot de nakomelingen van het volgende: een XElement object, een XDocument object, een verzameling XElement objecten of een verzameling XDocument objecten.

Syntaxis

object...<descendant>

generator

object Vereist. Een XElement object, een XDocument object, een verzameling XElement objecten of een verzameling XDocument objecten.

...< Vereist. Geeft het begin aan van een eigenschap van een onderliggende as.

descendant Vereist. Naam van de onderliggende knooppunten voor toegang tot het formulier [prefix:]name.

Onderdeel Beschrijving
prefix Optioneel. XML-naamruimtevoorvoegsel voor het onderliggende knooppunt. Moet een globale XML-naamruimte zijn die is gedefinieerd met behulp van een Imports instructie.
name Vereist. Lokale naam van het onderliggende knooppunt. Zie de namen van gedeclareerde XML-elementen en -kenmerken.

> Vereist. Geeft het einde van een onderliggende aseigenschap aan.

Retourwaarde

Een verzameling XElement objecten.

Opmerkingen

U kunt een eigenschap van de onderliggende XML-as gebruiken om toegang te krijgen tot onderliggende knooppunten op naam van een XElement of XDocument object, of uit een verzameling XElement of XDocument objecten. Gebruik de XML-eigenschap Value voor toegang tot de waarde van het eerste onderliggende knooppunt in de geretourneerde verzameling. Zie de eigenschap XML-waarde voor meer informatie.

De Visual Basic-compiler converteert onderliggende aseigenschappen naar aanroepen naar de Descendants methode.

XML-naamruimten

De naam in een eigenschap van een onderliggende as kan alleen XML-naamruimten gebruiken die globaal zijn gedeclareerd met de Imports instructie. Er kunnen geen XML-naamruimten worden gebruikt die lokaal zijn gedeclareerd binnen letterlijke xml-elementen. Zie Importinstructie (XML-naamruimte) voor meer informatie.

Voorbeeld 1

In het volgende voorbeeld ziet u hoe u toegang krijgt tot de waarde van het eerste onderliggende knooppunt met de naam name en de waarden van alle onderliggende knooppunten met de naam phone van het contacts object.

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))

Met deze code wordt de volgende tekst weergegeven:

Name: Patrick Hines

Home Phone = 206-555-0144

Voorbeeld 2

In het volgende voorbeeld wordt het voorvoegsel van de XML-naamruimte opgegeven ns . Vervolgens wordt het voorvoegsel van de naamruimte gebruikt om een letterlijke XML-waarde te maken en toegang te krijgen tot de waarde van het eerste onderliggende knooppunt met de gekwalificeerde naam 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

Met deze code wordt de volgende tekst weergegeven:

Name: Patrick Hines

Zie ook