Propriedade do indexador de extensão (Visual Basic)

Artigo
06/08/2015

Fornece acesso aos elementos individuais em uma coleção.

object(index)

Partes

Termo	Definição
object	Obrigatório. Uma coleção consultável. Ou seja, uma coleção que implementa IEnumerable ou IQueryable.
(	Obrigatório. Indica o início da propriedade do indexador.
index	Obrigatório. Uma expressão inteira que especifica a posição de um elemento da coleção baseada em zero.
)	Obrigatório. Denota final da propriedade do indexador.

Valor de retorno

O objeto a partir do local especificado na coleção, ou Nothing se o índice estiver fora do intervalo.

Comentários

Você pode usar a propriedade do indexador de extensão para acessar elementos individuais em uma coleção. Essa propriedade do indexador normalmente é usada na saída das propriedades do eixo XML. As propriedades do XML filho e do eixo XML descendente retornam coleções de objetos XElement ou um valor de atributo.

O Visual Basic compilador converte propriedades do indexador de extensão para chamadas para oElementAtOrDefault método. Ao contrário de um indexador de matriz, oElementAtOrDefault método retorna Nothing se o índice está fora do intervalo. Esse comportamento é útil quando você não pode facilmente determinar o número de elementos em uma coleção.

Esta propriedade do indexador é como uma propriedade de extensão para coleções que implementam IEnumerable ou IQueryable: Ele é usado somente se a coleção não possui um indexador ou uma propriedade padrão.

Para acessar o valor do primeiro elemento em uma coleção de objetos XElement ou XAttribute, você pode usar a propriedade Value do XML. Para obter mais informações, consulte Propriedade do valor XML (Visual Basic).

Exemplo

O exemplo a seguir mostra como usar o indexador de extensão para acessar o segundo nó filho em uma coleção de objetos XElement. A coleção é acessada através de propriedade do eixo filho, que obtém todos os elementos filho chamados phone no objeto contact.

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)

Esse código exibe o texto a seguir:

Second phone number: 425-555-0145