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

Definition

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

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

Required. 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 platziert, bevor das durch das Before Argument identifizierte Element. Wenn Before es sich um einen numerischen Ausdruck handelt, muss es sich um eine Zahl zwischen 1 und dem Wert der Eigenschaft der Auflistung Count handeln. Wenn Before es sich um einen String Ausdruck handelt, muss sie der schlüsselzeichenfolge entsprechen, die angegeben wurde, wenn das Element, auf das verwiesen wird, der Auflistung hinzugefügt wurde. Sie können nicht sowohl als Afterauch Before .

After
Object

Dies ist optional. Ein Ausdruck, der eine relative Position in der Auflistung angibt. Das hinzuzufügende Element wird in der Auflistung platziert, nachdem das durch das After Argument identifizierte Element. Wenn After es sich um einen numerischen Ausdruck handelt, muss es sich um eine Zahl zwischen 1 und dem Wert der Eigenschaft der Auflistung Count handeln. Wenn After es sich um einen String Ausdruck handelt, muss sie der Schlüsselzeichenfolge entsprechen, die angegeben wurde, wenn das Element, auf das verwiesen wird, der Auflistung hinzugefügt wurde. Sie können nicht sowohl als Afterauch Before .

Beispiele

Im folgenden Beispiel wird die Add Methode verwendet, um Objekte - child Instanzen einer Klasse, die eine childPublic Eigenschaft name enthält - einer Auflistung hinzuzufügen, die aufgerufen wird family. Um zu sehen, wie dies funktioniert, erstellen Sie eine Form mit zwei Button Steuerelementen, und legen Sie deren Text Eigenschaften auf Add und List. Fügen Sie die child Klassendefinition und die family Deklaration zum Formularcode hinzu. Ändern Sie die _Click Ereignishandler für die Schaltflächen "Hinzufügen" und "Liste " wie dargestellt. Mit der Schaltfläche " Hinzufügen " können Sie untergeordnete Elemente hinzufügen. Die Schaltfläche "Liste " zeigt die Namen aller untergeordneten Elemente an.

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

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

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

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

Gilt für: