Como: Criar uma coleção de objetos

Como com qualquer objeto, você declara uma variável para armazenar o objeto e, em seguida, cria o objeto coleção e o atribui para a variável.

Para um objeto coleção, você pode usar tanto a classe de coleção Coleção de Classes do Visual Basic como .NET Framework.Em particular, você pode criar uma coleção Generic usando uma das classes no namespace System.Collections.Generic.Uma coleção genérica é útil quando cada item na coleção tem o mesmo tipo de dados.Coleções genéricas aplicam tipamento forte , permitindo que apenas o tipo de dados desejado seja adicionado.Para obter mais informações, consulte Como: Definir conjuntos de fortemente tipado.

Depois que o objeto da coleção é criado, você pode adicionar e remover itens e acessar itens na coleção.

Dois exemplos sobre como criar coleções a seguir.Cada coleção contém itens String e associa uma chave String com cada item.Os dois primeiros procedimentos criam uma coleção a classe de coleção Visual Basic.Os dois últimos procedimentos criam uma coleção usando uma classe de coleção genérica .NET Framework.

Criar uma coleção usando a classe coleção Visual Basic

1. Declare e crie uma variável Visual Basic Collection, como mostra o exemplo a seguir.

   Dim sampleVisualBasicColl As New Microsoft.VisualBasic.Collection()
   

   A coleção na sampleVisualBasicColl pode aceitar itens de qualquer tipo de dados.

2. Use o Método Add (objeto da coleção) para adicionar elementos à coleção.O exemplo a seguir cria quatro elementos String e os adiciona à coleção.Ele cria um valor exclusivo String como chave para cada novo elemento e passa esse valor para o método Add.

   Dim item1, item2, item3, item4 As String
   item1 = "Items"
   item2 = "In"
   item3 = "A"
   item4 = "Collection"
   sampleVisualBasicColl.Add(item1, "firstkey")
   sampleVisualBasicColl.Add(item2, "secondkey")
   sampleVisualBasicColl.Add(item3, "thirdkey")
   sampleVisualBasicColl.Add(item4, "fourthkey")
   

   O argumento Key é opcional de uma coleção Visual Basic.

3. Se você quiser remover um elemento da coleção, você pode usar o Método Remove (Objeto Coleção), identificando o elemento por seu índice posicional ou por sua chave opcional.O exemplo a seguir ilustra isto:

   ' Remove the first element of the Visual Basic collection.
   sampleVisualBasicColl.Remove(1)
   ' Remove the element with the key "secondkey".
   sampleVisualBasicColl.Remove("secondkey")
   

   Observe que quando um elemento é removido de uma Visual Basic Collection, os valores de índice são renumerados de 1 até o valor da Propriedades de Contagem ( Objeto de coleção)..

Utilizar For Each... Next para processar os elementos de sua coleção Visual Basic

1. Declare uma variável do tipo armazenado na coleção.Para o exemplo anterior, declare uma variável do tipo String, como mostra a exemplo a seguir.

   ' Insert code from the preceding example.
   Dim aString As String
   

2. Use um For each... Next demonstrativo (Visual Basic) para examinar cada elemento da coleção.O exemplo a seguir procura por uma determinada string e exibe-a se encontrada.

   For Each aString in sampleVisualBasicColl
       If aString = "Collection" Then
           MsgBox(aString)
       End If
   Next aString
   

Criando uma coleção usando uma classe de coleção genérica.

1. Declare e crie uma variável .NET Framework System.Collections.Generic.Dictionary<TKey, TValue>, como mostra o exemplo a seguir.

   Dim sampleGenericColl As New System.Collections.Generic.Dictionary(Of String, String)
   

   A variável sampleGenericColl contém uma coleção type-Safe que aceita itens e as chaves apenas do tipo String.

2. Use o método Dictionary<TKey, TValue>.Add para adicionar elementos à coleção.O exemplo a seguir cria quatro elementos String e os adiciona à coleção.Ele cria um valor exclusivo String como chave para cada novo elemento e passa esse valor para o método Add.

   Dim item1, item2, item3, item4 As String
   item1 = "Items"
   item2 = "In"
   item3 = "A"
   item4 = "Collection"
   sampleGenericColl.Add("firstkey", item1)
   sampleGenericColl.Add("secondkey", item2)
   sampleGenericColl.Add("thirdkey", item3)
   sampleGenericColl.Add("fourthkey", item4)
   

   O argumento Key é necessário nesta coleção genérica.

3. Para remover um elemento da coleção, use o método IDictionary<TKey, TValue>.Remove.Você deve fornecer a chave para identificar o elemento a ser removido.O exemplo a seguir ilustra isto:

   If Not sampleGenericColl.Remove("thirdkey")
       ' Insert code to handle "thirdkey" not found in collection.
   End If
   

   Você pode usar uma instrução For Each...Next para executar um loop e processar os elementos de uma coleção, como demonstra o procedimento a seguir.

Utilizar For Each... Next para processar os elementos de sua coleção genérica

1. Declare uma variável do tipo armazenado na coleção.Para o exemplo anterior, declare uma variável do tipo String, como mostra a exemplo a seguir.

   ' Insert code from the preceding example.
   Dim aPair As KeyValuePair(Of String, String)
   

2. Use um For each... Next demonstrativo (Visual Basic) para examinar cada elemento da coleção.O exemplo a seguir procura por uma determinada string e exibe-a se encontrada.

   For Each aPair In sampleGenericColl
       If aPair.Value = "Items" Then
           MsgBox(aPair.Key & " -- " & aPair.Value)
       End If
   Next aPair
   

Consulte também

Tarefas

Como: Criar uma matriz de objetos

Conceitos

Coleção de Classes do Visual Basic

Referência

System.Collections

System.Collections.Generic

System.Collections.Specialized

Objetos de Coleção (Visual Basic)