Add-Methode (VBA)

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.

Hinweise

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 sowohl mit als auch ohne Schlüssel Zeichenfolgen hinzuzufügen. Die Item-Methode wird implizit verwendet, um jede Zeichenfolge abzurufen.

Dim c As Collection
Set c = New Collection

c.Add "a"
c.Add "c", "CC"
c.Add "b", "BB", 2
c.Add "d"

Debug.Print c(1) ' --> prints "a"
Debug.Print c(2) ' --> prints "b"
Debug.Print c(3) ' --> prints "c"

Debug.Print c("BB") ' --> prints "b"
Debug.Print c("d") ' --> error (no key was specified for this element - a positional index must be used)

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.

  • Last updated on