Propriedade do indexador de extensão (Visual Basic)
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<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.
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<T> ou IQueryable<T>: 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 Value 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
Consulte também
Referência
Propriedade Value XML (Visual Basic)