Eigenschap onderliggende XML-as (Visual Basic)
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
