Eigenschap xml-afstammelingsas (Visual Basic)
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
