Propriedade Item (Objeto Coleção)

Artigo
08/25/2010

Retorna um elemento específico de um objeto Collection por posição ou por chave.Somente leitura.

Default Public ReadOnly Property Item( _
    ByVal { Key As String | Index As Integer | Index As Object } _
) As Object

Parâmetros

Key
Um único String expressão que especifica uma chave em seqüência que pode ser usado, em vez de um índice posicional, para acesso um elemento da coleção. Key deve corresponder da Key argumento especificado quando o elemento foi adicionado à coleção.
Index
(A) uma expressão numérica que especifica a posição de um elemento da coleção.Index deve ser um número entre 1 e o valor da coleção Propriedades de Contagem ( Objeto de coleção).. Ou (B) uma expressão Object que especifica a posição ou sequência de caracteres chave de um elemento da coleção.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	Key é inválido ou não coincide com um elemento existente da coleção. Index não pode ser interpretado como dados numéricos ou de caracteres.
IndexOutOfRangeException	9	Key é Nothing. Index não coincide com um elemento existente da coleção.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

Se Index é do tipo Object, a propriedade Item tentará tratá-lo como String, Char,matriz de Char, ou valor inteiro.Se Item não pode converter Index para String ou Integer, ele gera uma exceção ArgumentException.

A propriedade Item é a propriedade padrão para uma coleção.Portanto, as linhas de código a seguir são equivalentes.

MsgBox(CStr(customers.Item(1)))
MsgBox(CStr(customers(1)))

Exemplo

O exemplo a seguir usa a propriedade Item para recuperar uma referência a um objeto em uma coleção.Ele cria birthdays como um objeto Collection e, em seguida, recupera o objeto que representa o aniversário de Bill, usando a chave "Bill" como o argumento Index.

Dim birthdays As New Collection()
birthdays.Add(New DateTime(2001, 1, 12), "Bill")
birthdays.Add(New DateTime(2001, 1, 13), "Joe")
birthdays.Add(New DateTime(2001, 1, 14), "Mike")
birthdays.Add(New DateTime(2001, 1, 15), "Pete")


...


Dim aBirthday As DateTime
aBirthday = birthdays.Item("Bill")
MsgBox(CStr(aBirthday))
aBirthday = birthdays("Bill")
MsgBox(CStr(aBirthday))

Observe que a primeira chamada especifica explicitamente a propriedade Item, mas o segundo não.Ambas as chamadas funcionam porque a propriedade Item é a propriedade padrão para um objeto Collection.