Eigenschap Extensie-indexeerfunctie (Visual Basic)
Biedt toegang tot afzonderlijke elementen in een verzameling.
Syntaxis
object(index)
generator
| Term | Definitie |
|---|---|
object |
Vereist. Een opvraagbare verzameling. Dat wil gezegd, een verzameling die implementeert IEnumerable<T> of IQueryable<T>. |
| ( | Vereist. Geeft het begin van de eigenschap indexeerfunctie aan. |
index |
Vereist. Een geheel getalexpressie die de op nul gebaseerde positie van een element van de verzameling aangeeft. |
| ) | Vereist. Geeft het einde van de eigenschap indexeerfunctie aan. |
Retourwaarde
Het object van de opgegeven locatie in de verzameling of Nothing als de index buiten het bereik valt.
Opmerkingen
U kunt de eigenschap extensie-indexeerfunctie gebruiken om toegang te krijgen tot afzonderlijke elementen in een verzameling. Deze indexeerfunctieeigenschap wordt doorgaans gebruikt voor de uitvoer van XML-aseigenschappen. De eigenschappen van de onderliggende XML- en XML-afstammingsas retourneren verzamelingen objecten XElement of een kenmerkwaarde.
De Visual Basic-compiler converteert eigenschappen van de extensie-indexeerfunctie naar aanroepen naar de ElementAtOrDefault methode. In tegenstelling tot een matrixindexeerfunctie retourneert Nothing de ElementAtOrDefault methode als de index buiten het bereik valt. Dit gedrag is handig wanneer u het aantal elementen in een verzameling niet eenvoudig kunt bepalen.
Deze indexeerfunctieeigenschap is net als een extensie-eigenschap voor verzamelingen die implementeren IEnumerable<T> of IQueryable<T>: deze wordt alleen gebruikt als de verzameling geen indexeerfunctie of een standaardeigenschap heeft.
Als u toegang wilt tot de waarde van het eerste element in een verzameling of XElementXAttribute objecten, kunt u de XML-eigenschap Value gebruiken. Zie de eigenschap XML-waarde voor meer informatie.
Opmerking
In het volgende voorbeeld ziet u hoe u de extensieindexeerfunctie gebruikt voor toegang tot het tweede onderliggende knooppunt in een verzameling XElement objecten. De verzameling wordt geopend met behulp van de eigenschap onderliggende as, waarmee alle onderliggende elementen in het contact object worden opgehaaldphone.
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("Second phone number: " & contact.<phone>(1).Value)
Met deze code wordt de volgende tekst weergegeven:
Second phone number: 425-555-0145
