Eigenschap XML-waarde (Visual Basic)

Artikel
03/05/2024

Biedt toegang tot de waarde van het eerste element van een verzameling XElement objecten.

Syntaxis

object.Value

generator

Term	Definitie
`object`	Vereist. XElement Verzameling objecten.

Retourwaarde

Een String met de waarde van het eerste element van de verzameling of Nothing als de verzameling leeg is.

Opmerkingen

De Value eigenschap maakt het eenvoudig om toegang te krijgen tot de waarde van het eerste element in een verzameling XElement objecten. Met deze eigenschap wordt eerst gecontroleerd of de verzameling ten minste één object bevat. Als de verzameling leeg is, retourneert Nothingdeze eigenschap . Anders retourneert deze eigenschap de waarde van de Value eigenschap van het eerste element in de verzameling.

Notitie

Wanneer u de waarde van een XML-kenmerk opent met behulp van de id @, wordt de kenmerkwaarde geretourneerd als een String en hoeft u de Value eigenschap niet expliciet op te geven.

Als u toegang wilt krijgen tot andere elementen in een verzameling, kunt u de eigenschap xml-extensieindexeerfunctie gebruiken. Zie De eigenschap Extension Indexer voor meer informatie.

Overname

De meeste gebruikers hoeven deze sectie niet te implementeren IEnumerable<T>en kunnen daarom deze sectie negeren.

De Value eigenschap is een extensie-eigenschap voor typen die implementeren IEnumerable(Of XElement). De binding van deze extensie-eigenschap is net als de binding van extensiemethoden: als een type een van de interfaces implementeert en een eigenschap definieert met de naam 'Waarde', heeft die eigenschap voorrang op de extensie-eigenschap. Met andere woorden, deze Value eigenschap kan worden overschreven door een nieuwe eigenschap te definiëren in een klasse die wordt geïmplementeerd IEnumerable(Of XElement).

Voorbeeld 1

In het volgende voorbeeld ziet u hoe u de Value eigenschap gebruikt voor toegang tot het eerste knooppunt in een verzameling XElement objecten. In het voorbeeld wordt de eigenschap onderliggende as gebruikt om de verzameling op te halen van alle onderliggende knooppunten met de naam phone die zich in het contact object bevinden.

Dim contact As XElement = 
    <contact>
        <name>Patrick Hines</name>
        <phone type="home">206-555-0144</phone>
        <phone type="work">425-555-0145</phone>
    </contact>

Console.WriteLine("Phone number: " & contact.<phone>.Value)

Met deze code wordt de volgende tekst weergegeven:

Phone number: 206-555-0144

Voorbeeld 2

In het volgende voorbeeld ziet u hoe u de waarde van een XML-kenmerk ophaalt uit een verzameling XAttribute objecten. In het voorbeeld wordt de eigenschap kenmerkas gebruikt om de waarde van het type kenmerk voor alle phone elementen weer te geven.

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 types = contact.<phone>.Attributes("type")

For Each attr In types
  Console.WriteLine(attr.Value)
Next

Met deze code wordt de volgende tekst weergegeven:

home
work

Share via