Collection Klasse

Definition

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

Vererbung

Object

Collection

Attribute

SerializableAttribute

Implementiert

ICollection IEnumerable IList IDeserializationCallback ISerializable

Beispiele

Im folgenden Beispiel werden das Collection -Objekt names und ein Dialogfeld erstellt, mit dem ein Benutzer objekte (Namen) zur Auflistung hinzufügen kann. Anschließend werden die Namen in der Auflistung angezeigt und schließlich die Auflistung geleert, ohne das Collection Objekt selbst zu löschen.

Um zu sehen, wie dies funktioniert, wählen Sie im Menü Projekt den Befehl Klasse hinzufügen aus, und deklarieren Sie eine öffentliche Variable namens instanceName auf Modulebene nameClass (TypPublic instanceName), um die Namen der einzelnen instance zu enthalten. Übernehmen Sie den Standardnamen als nameClass. Kopieren Sie den folgenden Code, fügen Sie ihn in den Abschnitt Allgemein eines anderen Moduls ein, und beginnen Sie ihn dann mit der -Anweisung classNamer in einer anderen Prozedur. (Dieses Beispiel funktioniert nur mit Hostanwendungen, die Klassen unterstützen.)

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

Hinweise

Das Visual Basic-Objekt Collection bietet eine bequeme Möglichkeit, auf eine verknüpfte Gruppe von Elementen als einzelnes Objekt zu verweisen. Die Elemente oder Elemente in einer Auflistung müssen nur durch die Tatsache verknüpft werden, dass sie in der Auflistung vorhanden sind. Elemente einer Auflistung müssen nicht denselben Datentyp verwenden.

Sie können eine Auflistung auf die gleiche Weise wie andere Objekte erstellen, wie im folgenden Beispiel veranschaulicht.

Dim coll As New Microsoft.VisualBasic.Collection()  

Nachdem Sie eine Sammlung erstellt haben, können Sie eine der folgenden Aktionen ausführen:

• Fügen Sie ein -Element mit der Add -Methode hinzu.

• Entfernen Sie ein Element mit der Remove -Methode.

• Entfernen Sie alle Elemente mit der Clear -Methode.

• Ermitteln Sie, wie viele Elemente die Auflistung mit der Count -Eigenschaft enthält.

• Überprüfen Sie, ob ein bestimmtes Element mit der Contains -Methode vorhanden ist.

• Gibt ein bestimmtes Element aus der Auflistung mit der Item[] -Eigenschaft zurück.

• Durchlaufen Sie die gesamte Sammlung mit for Each... Next-Anweisung.

  Hinweis

  Obwohl das Visual Basic-Objekt Collection über funktionen verfügt, die mit dem Collection -Objekt in Visual Basic 6.0 identisch sind, können beide nicht in einer COM-Umgebung zusammenarbeiten.

  Achtung

  Das Durchlaufen einer Visual Basic-Datei Collection ist keine threadsichere Prozedur. Selbst wenn die Auflistung synchronisiert wird, können andere Threads die Auflistung weiterhin ändern, sodass der Enumerator eine Ausnahme auslöst. Um die Threadsicherheit während der Enumeration zu gewährleisten, sperren Sie entweder die Auflistung, oder fangen Sie die Ausnahmen ab, die sich aus änderungen ergeben, die von anderen Threads vorgenommen wurden. Weitere Informationen zum Sperren eines Programmierelements finden Sie unter SyncLock-Anweisung.

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für: