Como: Adicionar, excluir e recuperar itens de uma coleção

Artigo
08/25/2010

A classe Visual Basic Collection contém funcionalidade interna para permitir que você adicione, exclua e recupere itens.

Convém adicionar um item a uma coleção assim que o item é recém-criado ou obtido, como um novo cliente.
Convém excluir um item de uma coleção quando ele não pertence mais à coleção, por exemplo, quando um funcionário deixa a empresa.
Convém recuperar um item de uma coleção para editar seu conteúdo, por exemplo para alterar o número de telefone de um aluno.

Observação:
Objetos Collection atualizam seus números de índice numérico automaticamente à medida que você adicionar e excluir os elementos.Devido a isso, o índice numérico de um determinado elemento pode alterar com frequência.Portanto, não salve um valor de índice numérico e espere recuperar o mesmo elemento posteriormente no seu programa.Use chaves para essa finalidade.

Para adicionar um item a uma coleção

Use o Método Add (objeto da coleção) e especifique o item por seu Key.

object.Add(Item, Key [, {Before | After}])

Por exemplo, para adicionar um objeto de ordem de trabalho a uma coleção de ordens de trabalho usando a propriedade ID da ordem de trabalho como sua chave, você pode fazer a chamada a seguir.
```
workOrders.Add(woNew, woNew.ID)
```
A chamada anterior pressupõe que a propriedade ID é uma sequência de caracteres.Se for um número (por exemplo, um número inteiro Long), use o método ToString para convertê-lo para o valor String necessário para o argumento Key.
```
workOrders.Add(woNew, woNew.ID.ToString())
```
O uso de uma chave é opcional.Se você não desejar associar uma chave ao objeto na sua coleção, é possível adicioná-lo sem uma chave.
```
workOrders.Add(woNew)
```
Você pode usar os argumentos Before e After opcionais para manter uma coleção ordenada de objetos.O item a ser adicionado é colocado na coleção antes ou após o item identificado pelo Before ou After, respectivamente.Por exemplo, definir Before igual a 1 insere um item no início da coleção, porque objetos Collection são baseados em 1.
```
workOrders.Add(woNew, woNew.ID, 1)
```
Da mesma forma, o argumento After adiciona um item após o índice especificado.O exemplo a seguir adiciona um item como o terceiro elemento.
```
workOrders.Add(woNew, woNew.ID,,2)
```
Você pode especificar um valor para Before ou After, mas não para ambos.

Para excluir um item de uma coleção

Use o Método Remove (Objeto Coleção) e especifique o item por seu Index ou por sua Key.

object.Remove({Index | Key})

O argumento Index é a posição do item que você deseja excluir.O argumento Key é a mesma sequência de caracteres que você usou para adicionar o item à coleção.Se a chave do terceiro elemento em uma coleção for "W017493", você pode usar qualquer uma das duas instruções as seguir para excluí-lo.
```
workOrders.Remove(3)
workOrders.Remove("W017493")
```

Para excluir todos os itens de uma coleção

Use o Método Clear (Objeto Coleção).

object.Clear()

O método Clear esvazia a coleção.

Para recuperar um item de uma coleção

Use o Propriedade Item (Objeto Coleção) e especifique o item por seu Index ou por sua Key.

variable = object.Item({Index | Key})

Como com o método Remove, o argumento Index é a posição do item na coleção, e o argumento Key é a sequência de caracteres usada quando o item foi adicionado.Usando o mesmo exemplo que para o método Remove, qualquer uma das instruções a seguir recupera o terceiro elemento na coleção.

woCurrent = workOrders.Item(3)
woCurrent = workOrders.Item("W017493")

Observação:
Se você usar números sistema autônomo chaves, você deve usar seus ToString métodos para convertê-los em seqüências de caracteres antes de transmiti-los para o Add ou Remove método, ou para o Item propriedade. Um objeto Visual Basic Collection sempre pressupõe que um número é um índice, em vez de uma sequência de caracteres chave.

Se você souber a chave no tempo de compilação, você pode usar como alternativa o operador de acesso do dicionário (!) para acessar um elemento da coleção sem colocar a chave entre aspas ou parênteses.A chamada anterior pode ser escrita da seguinte maneira.
```
woCurrent = workOrders!W017493
```