Collection Classe

Definição

public ref class Collection sealed : System::Collections::IList

public ref class Collection sealed : System::Collections::IList, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable

public sealed class Collection : System.Collections.IList

[System.Serializable]
public sealed class Collection : System.Collections.IList, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable

type Collection = class
    interface ICollection
    interface IEnumerable
    interface IList

type Collection = class
    interface ICollection
    interface IList

[<System.Serializable>]
type Collection = class
    interface ICollection
    interface IList
    interface ISerializable
    interface IDeserializationCallback

Public NotInheritable Class Collection
Implements IList

Public NotInheritable Class Collection
Implements IDeserializationCallback, IList, ISerializable

Herança

Object

Collection

Atributos

SerializableAttribute

Implementações

ICollection IEnumerable IList IDeserializationCallback ISerializable

Exemplos

O exemplo a seguir cria o Collection objeto names e uma caixa de diálogo com a qual um usuário pode adicionar objetos (nomes) à coleção. Em seguida, ele exibe os nomes na coleção e, por fim, esvazia a coleção sem descartar o Collection próprio objeto.

Para ver como isso funciona, escolha o comando Adicionar Classe no menu Projeto e declare uma variável pública chamada instanceName no nível do módulo de nameClass (tipo Public instanceName) para manter os nomes de cada instância. Deixe o nome predefinido como nameClass. Copie e cole o código a seguir na seção Geral de outro módulo e inicie-o com a instrução classNamer em outro procedimento. (Este exemplo funciona apenas com aplicativos host que dão suporte a classes.)

Public Class nameClass
    Public instanceName As String
End Class
Sub classNamer()
    ' Create a Visual Basic Collection object.
    Dim names As New Microsoft.VisualBasic.Collection()
    Dim key As Integer
    Dim msg As String
    Dim name As String
    Dim nameList As String = ""
    ' 1. Get names from the user to add to the collection.
    Do
        Dim inst As New nameClass()
        key += 1
        msg = "Please enter a name for this object." & vbCrLf &
              "Press Cancel to see names in collection."
        name = InputBox(msg, "Name the Collection items")
        inst.instanceName = name
        ' If user entered a name, add it to the collection.
        If inst.instanceName <> "" Then
            names.Add(inst, CStr(key))
        End If
    Loop Until name = ""
    ' 2. Create and display a list of names from the collection.
    For Each oneInst As nameClass In names
        nameList &= oneInst.instanceName & vbCrLf
    Next oneInst
    MsgBox(nameList, , "Instance Names in names Collection")
    ' 3. Remove elements from the collection without disposing of the collection.
    For count As Integer = 1 To names.Count
        names.Remove(1)
        ' Since Visual Basic collections are reindexed automatically, 
        ' remove the first member on each iteration.
    Next count
End Sub

Comentários

O objeto Visual Basic Collection fornece uma maneira conveniente de se referir a um grupo relacionado de itens como um único objeto. Os itens, ou elementos, em uma coleção só precisam estar relacionados pelo fato de existirem na coleção. Elementos de uma coleção não precisam compartilhar o mesmo tipo de dados.

Você pode criar uma coleção da mesma forma que cria outros objetos, como ilustra o exemplo a seguir.

Dim coll As New Microsoft.VisualBasic.Collection()

Depois de criar uma coleção, você pode fazer qualquer uma das seguintes ações:

• Adicione um elemento com o Add método.

• Remova um elemento com o Remove método.

• Remova todos os elementos com o Clear método.

• Descubra quantos elementos a coleção contém com a Count propriedade.

• Verifique se um elemento específico está presente com o Contains método.

• Retorne um elemento específico da coleção com a Item[] propriedade.

• Iterar por toda a coleção com o For Each... Próxima instrução.

  Observação

  Embora o objeto Visual Basic Collection tenha funcionalidade idêntica ao Collection objeto no Visual Basic 6.0, os dois não podem interoperar em um ambiente COM.

  Cuidado

  Iterar por meio de um Visual Basic Collection não é um procedimento thread-safe. Mesmo que a coleção seja sincronizada, outros threads ainda poderão modificar a coleção, fazendo com que o enumerador gere uma exceção. Para garantir a segurança do thread durante a enumeração, bloqueie a coleção ou capture as exceções resultantes de alterações feitas por outros threads. Para obter mais informações sobre como bloquear um elemento de programação, consulte a Instrução SyncLock.