Właściwość indeksująca rozszerzenie (Visual Basic)

Artykuł
02/27/2013

Zapewnia dostęp do poszczególnych elementów w kolekcji.

object(index)

Części

Termin	Definicja
object	Wymagane.Kolekcja queryable.Oznacza to, który implementuje kolekcji IEnumerable<T> lub IQueryable<T>.
(	Wymagane.Oznacza początek właściwości indeksowania.
index	Wymagane.Wyrażenie liczby całkowitej, która określa położenie elementu w kolekcji od zera.
)	Wymagane.Oznacza koniec właściwości indeksowania.

Wartość zwracana

Obiekt z określonej lokalizacji w kolekcji, lub Nothing Jeżeli indeks jest poza zakresem.

Uwagi

Właściwość extension indeksowania można użyć do uzyskania dostępu do poszczególnych elementów w kolekcji.Tej właściwości w indeksatorze jest zazwyczaj używany w danych wyjściowych XML osi właściwości.Podrzędnych XML i właściwości elementów potomnych osi XML z powrotem kolekcje XElement obiektów lub wartość atrybutu.

Visual Basic Kompilatora konwertuje właściwości indeksatora rozszerzenia do wywołańElementAtOrDefault metody. W przeciwieństwie do indeksowania tablicyElementAtOrDefault metoda zwraca Nothing Jeżeli indeks jest poza zakresem.To zachowanie jest przydatne, gdy nie można łatwo określić liczbę elementów w kolekcji.

Tej właściwości w indeksatorze przypomina właściwość extension zbierania danych, które implementują IEnumerable<T> lub IQueryable<T>: jest używany tylko wtedy, gdy kolekcja nie indeksowanie lub domyślnej właściwości.

Do uzyskania dostępu do wartości pierwszego elementu w kolekcji z XElement lub XAttribute obiektów, można użyć kodu XML Value właściwości.Aby uzyskać więcej informacji, zobacz Właściwość wartość XML (Visual Basic).

Przykład

Poniższy przykład ilustruje użyć indeksatora rozszerzenie drugiego węzła podrzędnego w kolekcji z dostępu do XElement obiektów.Kolekcja jest dostępny przy użyciu właściwości osi podrzędnej, które pobiera wszystkie elementy podrzędne o nazwie phone w contact obiektu.

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)

Ten kod wyświetla następujący tekst:

Second phone number: 425-555-0145