Add-Methode (VBA)

  • Artikel

Fügt einem Collection-Objekt ein Element hinzu.

Syntax

-Objekt.Element,Schlüssel, vor, nach hinzugefügt

Die Syntax der Add-Methode beinhaltet den folgenden Objektbezeichner und die folgenden benannten Argumente:

Teil Beschreibung
Objekt Erforderlich. Ein Objektausdruck, der als ein Objekt in der Liste Gilt für ausgewertet wird.
Element Erforderlich. Ein Ausdruck eines beliebigen Typs, der das Element angibt, das der Auflistung hinzugefügt werden soll.
key Optional. Ein eindeutiger Zeichenfolgenausdruck zur Angabe einer Schlüsselzeichenfolge, die anstelle eines Positionierungsindex für den Zugriff auf ein Element der Auflistung verwendet werden kann.
Bevor Optional. Ein Ausdruck, der eine relative Position in der Auflistung angibt. Das hinzuzufügende Element wird in der Auflistung vor dem durch das before-Argument identifizierten Member platziert. Bei einem numerischen Ausdruck muss vorher eine Zahl zwischen 1 und dem Wert der Count-Eigenschaft der Auflistung sein. Bei einem Zeichenfolgenausdruck muss vor dem Schlüssel entsprechen, der beim Hinzufügen des Elements, auf das verwiesen wird, zu der Auflistung angegeben wurde. Sie können eine vor-Position oder eine nach-Position, jedoch nicht beide Positionstypen gleichzeitig angeben.
Nach Optional. Ein Ausdruck, der eine relative Position in der Auflistung angibt. Das hinzuzufügende Element wird in der Auflistung nach dem Element positioniert, das durch das nach-Argument identifiziert wurde. Wenn es sich um einen numerischen Ausdruck handelt, muss nach eine Zahl zwischen 1 und dem Wert der Count-Eigenschaft der Auflistung sein. Bei einem Zeichenfolgenausdruck muss nach dem Schlüssel entsprechen, der beim Hinzufügen des Elements, auf das verwiesen wird, zu der Auflistung angegeben wurde. Sie können eine vor-Position oder eine nach-Position, jedoch nicht beide Positionstypen gleichzeitig angeben.

HinwBemerkungeneise

Unabhängig davon, ob das Argument für vor oder nach ein Zeichenfolgenausdruck oder ein numerischer Ausdruck ist, muss es auf ein vorhandenes Element der Auflistung verweisen. Andernfalls tritt ein Fehler auf.

Ein Fehler tritt auch dann auf, wenn ein angegebener Schlüssel den Schlüssel für ein vorhandenes Element der Auflistung dupliziert.

Beispiel

In diesem Beispiel wird die Add-Methode verwendet, um Einer Auflistung MyClassesnamens Objekte (Instanzen einer Klasse namens mit Class1 der Public-VariablenInstanceName) hinzuzufügenInst. Um zu sehen, wie dies funktioniert, fügen Sie ein Klassenmodul ein, und deklarieren Sie eine öffentliche Variable namens InstanceName auf Modulebene ( Class1 Typ Public InstanceName), die die Namen der einzelnen Instanzen enthält. Behalten Sie den Standardnamen bei Class1. Kopieren Sie den folgenden Code, und fügen Sie ihn in die Form_Load Ereignisprozedur eines Formularmoduls ein.

Dim MyClasses As New Collection    ' Create a Collection object.
Dim Num As Integer    ' Counter for individualizing keys.
Dim Msg
Dim TheName    ' Holder for names user enters.
Do
    Dim Inst As New Class1    ' Create a new instance of Class1.
    Num = Num + 1    ' Increment Num, then get a name.
    Msg = "Please enter a name for this object." & Chr(13) _
     & "Press Cancel to see names in collection."
    TheName = InputBox(Msg, "Name the Collection Items")
    Inst.InstanceName = TheName    ' Put name in object instance.
    ' If user entered name, add it to the collection.
    If Inst.InstanceName <> "" Then
        ' Add the named object to the collection.
        MyClasses. Add item := Inst, key := CStr(Num)
    End If
    ' Clear the current reference in preparation for next one.
    Set Inst = Nothing
Loop Until TheName = ""
For Each x In MyClasses
    MsgBox x.instancename, , "Instance Name"
Next

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.