Compartilhar via


Método de item

Devolve um membro específico de um objeto coleção por posição ou por chave.

Sintaxe

objeto. Item(índice)

A sintaxe do método Item tem o seguinte qualificador de objeto e parte.

Sair Descrição
objeto Obrigatório. Uma expressão do objeto que é avaliada como um objeto na lista Aplica-se a.
índice Obrigatório. Uma expressão que especifica a posição de um membro da coleção. Se uma expressão numérica, o índice tem de ser um número de 1 para o valor da propriedade Contar da coleção. Se uma expressão de cadeia, o índice tem de corresponder ao argumentochave especificado quando o membro referido foi adicionado à coleção.

Comentários

Se o valor fornecido como índice não corresponder a nenhum membro existente da coleção, ocorrerá um erro. O método Item é o método predefinido para uma coleção. Por conseguinte, as seguintes linhas de código são equivalentes:

Print MyCollection(1)
Print MyCollection.Item(1)

Exemplo

Este exemplo utiliza o método Item para obter uma referência a um objeto numa coleção. Partindo do princípio Birthdays de que é um objeto coleção , o seguinte código obtém das referências da coleção aos objetos que representam o aniversário de Bill Smith e o aniversário de Adam Smith, utilizando as chaves "SmithBill" e "SmithAdam" como argumentos de índice .

Tenha em atenção que a primeira chamada especifica explicitamente o método Item , mas a segunda não. Ambas as chamadas funcionam porque o método Item é a predefinição para um objeto Coleção . As referências, atribuídas a SmithBillBD e SmithAdamBD com Set, podem ser utilizadas para aceder às propriedades e métodos dos objetos especificados.

Para executar este código, crie a coleção e preencha-a com, pelo menos, os dois membros referenciados.

Dim SmithBillBD As Object
Dim SmithAdamBD As Object
Dim Birthdays
Set SmithBillBD = Birthdays.Item("SmithBill")
Set SmithAdamBD = Birthdays("SmithAdam")

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.