Collection Classe

Définition

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

Héritage

Object

Collection

Attributs

SerializableAttribute

Implémente

ICollection IEnumerable IList IDeserializationCallback ISerializable

Exemples

L’exemple suivant crée l’objet Collectionnames et une boîte de dialogue avec laquelle un utilisateur peut ajouter des objets (noms) à la collection. Il affiche ensuite les noms dans la collection, puis vide la collection sans supprimer l’objet Collection lui-même.

Pour voir comment cela fonctionne, choisissez la commande Ajouter une classe dans le menu Projet et déclarez une variable publique appelée instanceName au niveau du module de nameClass (type Public instanceName) pour contenir les noms de chaque instance. Conservez le nom par défaut .nameClass Copiez et collez le code suivant dans la section Général d’un autre module, puis démarrez-le avec l’instruction classNamer dans une autre procédure. (Cet exemple fonctionne uniquement avec les applications hôtes qui prennent en charge les 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

Remarques

L’objet Visual Basic Collection offre un moyen pratique de faire référence à un groupe d’éléments associé en tant qu’objet unique. Les éléments d’une collection doivent uniquement être liés par le fait qu’ils existent dans la collection. Les éléments d’une collection n’ont pas besoin de partager le même type de données.

Vous pouvez créer une collection de la même façon que vous créez d’autres objets, comme l’illustre l’exemple suivant.

Dim coll As New Microsoft.VisualBasic.Collection()  

Une fois que vous avez créé une collection, vous pouvez effectuer l’une des opérations suivantes :

• Ajoutez un élément avec la Add méthode .

• Supprimez un élément avec la Remove méthode .

• Supprimez tous les éléments avec la Clear méthode .

• Découvrez le nombre d’éléments que la collection contient avec la Count propriété .

• Vérifiez si un élément spécifique est présent avec la Contains méthode .

• Retourne un élément spécifique de la collection avec la Item[] propriété .

• Itérer dans l’ensemble de la collection avec for each... Next Statement.

  Notes

  Bien que l’objet Visual Basic Collection ait des fonctionnalités identiques à l’objet Collection dans Visual Basic 6.0, les deux ne peuvent pas interagir dans un environnement COM.

  Attention

  L’itération au sein d’un Visual Basic Collection n’est pas une procédure thread-safe. Même si la collection est synchronisée, d’autres threads peuvent toujours modifier la collection, ce qui entraîne la levée d’une exception par l’énumérateur. Pour garantir la sécurité des threads pendant l’énumération, verrouillez la collection ou interceptez les exceptions résultant des modifications apportées par d’autres threads. Pour plus d’informations sur le verrouillage d’un élément de programmation, consultez Instruction SyncLock.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

Méthodes d’extension

S’applique à