Compartilhar via

Propriedade Extension Indexer (Visual Basic)

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

Sintaxe

object(index)

Partes

Prazo Definição
object Obrigatório Uma coleção que pode ser consultada. Ou seja, uma coleção que implementa IEnumerable<T> ou IQueryable<T>.
( Obrigatório Denota o início da propriedade do indexador.
index Obrigatório Uma expressão inteiro que especifica a posição baseada em zero de um elemento da coleção.
) Obrigatório Denota o fim da propriedade do indexador.

Valor de retorno

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

Observações

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

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

Essa propriedade do indexador é como uma propriedade de extensão para coleções que implementam IEnumerable<T> ou IQueryable<T>: ela é usada somente se a coleção não tiver um indexador ou uma propriedade padrão.

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

Exemplo

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

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)

Este código exibe o seguinte texto:

Second phone number: 425-555-0145

Consulte também

  • Last updated on