Partilhar via


Propriedade Item (Objeto Coleção)

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.

Requisitos

Namespace: Microsoft.VisualBasic

**Módulo:**Collection

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Referência

Objetos de Coleção (Visual Basic)

Método Add (objeto da coleção)

Propriedades de Contagem ( Objeto de coleção).

Método Remove (Objeto Coleção)