Erweiterungsindexereigenschaft (Visual Basic)

Artikel
07/20/2011

Bietet Zugriff auf einzelne Elemente in einer Auflistung.

object(index)

Bestandteile

Ausdruck	Definition
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 Indexer-Erweiterungseigenschaften in Aufrufe der ElementAtOrDefault-Methode. Im Gegensatz zu einem Array-Indexer gibt die ElementAtOrDefault-Methode Nothing zurück, wenn der Index außerhalb des zulässigen Bereichs ist. 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 (Visual Basic).

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