Collection.Add(Object, String, Object, Object) Methode

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Quelle:

Collection.vb

Fügt einem Collection-Objekt ein Element hinzu.

public void Add (object? Item, string? Key = default, object? Before = default, object? After = default);

member this.Add : obj * string * obj * obj -> unit

Public Sub Add (Item As Object, Optional Key As String = Nothing, Optional Before As Object = Nothing, Optional After As Object = Nothing)

Parameter

Item

Object

Erforderlich. Ein Objekt eines beliebigen Typs, das das Element angibt, das der Auflistung hinzugefügt werden soll.

Key

String

Dies ist optional. Ein eindeutiger String-Ausdruck, der eine Schlüsselzeichenfolge angibt, die anstelle eines Positionsindex verwendet werden kann, um auf dieses neue Element in der Auflistung zuzugreifen.

Before

Object

Dies ist optional. Ein Ausdruck, der eine relative Position in der Auflistung angibt. Das hinzuzufügende Element wird in der Auflistung vor dem Element platziert, das vom Before-Argument angegeben wird. Wenn Before ein numerischer Ausdruck ist, muss es sich dabei um eine Zahl zwischen 1 und dem Wert der Count-Eigenschaft der Auflistung handeln. Ist Before ein String-Ausdruck, muss dieser der Schlüsselzeichenfolge entsprechen, die angegeben wurde, als das Element, auf das verwiesen wird, zur Auflistung hinzugefügt wurde. Sie können nicht gleichzeitig Before und After festlegen.

After

Object

Dies ist optional. Ein Ausdruck, der eine relative Position in der Auflistung angibt. Das hinzuzufügende Element wird in der Auflistung nach dem Element platziert, das vom After-Argument angegeben wird. Wenn After ein numerischer Ausdruck ist, muss es sich dabei um eine Zahl zwischen 1 und dem Wert der Count-Eigenschaft der Auflistung handeln. Ist After ein String-Ausdruck, muss dieser der Schlüsselzeichenfolge entsprechen, die angegeben wurde, als das Element, auf das verwiesen wird, zur Auflistung hinzugefügt wurde. Sie können nicht gleichzeitig Before und After festlegen.

Beispiele

Im folgenden Beispiel wird die Add -Methode verwendet, um einer Auflistung mit dem Namen familyObjekte hinzuzufügen child – Instanzen einer Klasse namenschild, die eine Public -Eigenschaft name enthält. Um zu sehen, wie dies funktioniert, erstellen Sie eine Form mit zwei Button Steuerelementen, und legen Sie deren Text Eigenschaften auf und ListfestAdd. Fügen Sie dem Formularcode die child Klassendefinition und die family Deklaration hinzu. Ändern Sie die _Click Ereignishandler für die Schaltflächen Hinzufügen und Auflisten wie gezeigt. Mit der Schaltfläche Hinzufügen können Sie untergeordnete Elemente hinzufügen. Auf der Schaltfläche Liste werden die Namen aller untergeordneten Elemente angezeigt.

Public Class child
    Public name As String
    Sub New(ByVal newName As String)
        name = newName
    End Sub
End Class
' Create a Collection object.
Private family As New Collection()
Private Sub addChild_Click() Handles Button1.Click
    Dim newName As String
    newName = InputBox("Name of new family member: ")
    If newName <> "" Then
        family.Add(New child(newName), newName)
    End If
End Sub
Private Sub listChild_Click() Handles Button2.Click
    For Each aChild As child In family
        MsgBox(aChild.name)
    Next
End Sub

Hinweise

Das Before Argument oder After muss auf ein vorhandenes Element der Auflistung verweisen. Andernfalls tritt ein Fehler auf.

Wenn sowohl die Before Argumente als After auch ausgelassen werden, wird das neue Objekt am Ende der Auflistung hinzugefügt.

Ein Fehler tritt auch auf, wenn ein angegebener Key Wert mit dem Schlüssel für ein vorhandenes Element der Auflistung übereinstimmt.