Propriedade do Indexador de Extensão

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

object(index)

Partes

  • object
    Obrigatório.Uma coleção consultável.Ou seja, uma coleção que implementa IEnumerable<T> ou IQueryable<T>.

  • (
    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.

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

Esta propriedade indexador é como uma propriedade de extensão para coleções que implementam IEnumerable<T> ou IQueryable<T>: Ele é usado somente se a coleção não tem 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 Valor XML.

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

Consulte também

Referência

XElement

Propriedade Valor XML

Outros recursos

Propriedades do eixo XML

Literais XML

Criando XML em Visual Basic