Erweiterungsindexereigenschaft
Aktualisiert: November 2007
Bietet Zugriff auf einzelne Elemente in einer Auflistung.
object(index)
Bestandteile
object
Erforderlich. Eine abfragbare Auflistung. Dabei handelt es sich um eine Auflistung, die IEnumerable<T> oder IQueryable<T> implementiert.(
Erforderlich. Kennzeichnet den Anfang der Indexereigenschaft.index
Erforderlich. Ein ganzzahliger Ausdruck, der die nullbasierte Position eines Elements der Auflistung angibt.)
Erforderlich. Kennzeichnet das Ende der Indexereigenschaft.
Rückgabewert
Das Objekt an der angegebenen Position in der Auflistung oder Nothing, wenn der Index außerhalb des Bereichs liegt.
Hinweise
Mit der Erweiterungsindexereigenschaft können Sie auf einzelne Elemente in einer Auflistung zugreifen. Diese Indexereigenschaft wird in der Regel für Ausgaben von XML-Achseneigenschaften verwendet. Die Achseneigenschaften des untergeordneten und des nachfolgenden XML-Elements geben Auflistungen von XElement-Objekten oder einen Attributwert zurück.
Der Visual Basic-Compiler konvertiert Erweiterungsindexereigenschaften in Aufrufe der ElementAtOrDefault-Methode. Im Gegensatz zu einem Arrayindexer gibt die ElementAtOrDefault-Methode Nothing zurück, wenn der Index außerhalb des Bereichs liegt. Dieses Verhalten ist nützlich, wenn Sie die Anzahl von Elementen in einer Auflistung nicht leicht ermitteln können.
Diese Indexereigenschaft ist vergleichbar mit der Erweiterungseigenschaft für Auflistungen, die IEnumerable<T> oder IQueryable<T> implementieren: Sie wird nur verwendet, wenn die Auflistung nicht über einen Indexer oder eine Standardeigenschaft verfügt.
Um auf den Wert des ersten Elements einer Auflistung von XElement-Objekten oder XAttribute-Objekten zuzugreifen, können Sie die Value-Eigenschaft von XML verwenden. Weitere Informationen finden Sie unter XML-Value-Eigenschaft.
Beispiel
Im folgenden Beispiel wird gezeigt, wie der Erweiterungsindexer für den Zugriff auf den zweiten untergeordneten Knoten in einer Auflistung von XElement-Objekten verwendet werden kann. Der Zugriff auf die Auflistung erfolgt mithilfe der untergeordneten Achseneigenschaft, die alle untergeordneten Elemente mit dem Namen phone im contact-Objekt abruft.
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)
Durch diesen Code wird folgender Text angezeigt:
Second phone number: 425-555-0145