Share via

Eigenschap onderliggende XML-as (Visual Basic)

  • Artikel

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

Syntaxis

object.<child>

generator

Term Definitie
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.
child Vereist. Naam van de onderliggende knooppunten die u wilt openen, van het formulier [prefix:]name.

- Prefix -Optionele. XML-naamruimtevoorvoegsel voor het onderliggende knooppunt. Moet een globale XML-naamruimte zijn die is gedefinieerd met een Imports instructie.
- Name -Vereist. Naam van lokaal onderliggend 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 een 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 eigenschappen van onderliggende as naar aanroepen naar de Elements methode.

XML-naamruimten

De naam in een eigenschap van een onderliggende as kan alleen xml-naamruimtevoorvoegsels gebruiken die globaal zijn gedeclareerd met de Imports instructie. Er kunnen geen xml-naamruimtevoorvoegsels 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 onderliggende knooppunten met de naam phone van het contact object.

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)

Met deze code wordt de volgende tekst weergegeven:

Home Phone = 206-555-0144

Voorbeeld 2

In het volgende voorbeeld ziet u hoe u toegang krijgt tot de onderliggende knooppunten die zijn benoemd phone uit de verzameling die wordt geretourneerd door de eigenschap van de contact onderliggende as van het contacts object.

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)

Met deze code wordt de volgende tekst weergegeven:

Home Phone = 206-555-0144

Voorbeeld 3

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 het eerste onderliggende knooppunt met de gekwalificeerde naam 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

Met deze code wordt de volgende tekst weergegeven:

Patrick Hines

Zie ook