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

Definition

Fügt einem Collection-Objekt ein Element hinzu.Adds an element to a Collection object.

public void Add (object? Item, string? Key = default, object? Before = default, object? After = default);
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.Required. Ein Objekt eines beliebigen Typs, das das Element angibt, das der Auflistung hinzugefügt werden soll.An object of any type that specifies the element to add to the collection.

Key
String

Dies ist optional.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.A unique String expression that specifies a key string that can be used instead of a positional index to access this new element in the collection.

Before
Object

Dies ist optional.Optional. Ein Ausdruck, der eine relative Position in der Auflistung angibt.An expression that specifies a relative position in the collection. Das hinzuzufügende Element wird in der Auflistung vor dem Element platziert, das vom Before-Argument angegeben wird.The element to be added is placed in the collection before the element identified by the Before argument. Wenn Before ein numerischer Ausdruck ist, muss es sich dabei um eine Zahl zwischen 1 und dem Wert der Count-Eigenschaft der Auflistung handeln.If Before is a numeric expression, it must be a number from 1 through the value of the collection's Count property. 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.If Before is a String expression, it must correspond to the key string specified when the element being referred to was added to the collection. Sie können nicht gleichzeitig Before und After festlegen.You cannot specify both Before and After.

After
Object

Dies ist optional.Optional. Ein Ausdruck, der eine relative Position in der Auflistung angibt.An expression that specifies a relative position in the collection. Das hinzuzufügende Element wird in der Auflistung nach dem Element platziert, das vom After-Argument angegeben wird.The element to be added is placed in the collection after the element identified by the After argument. Wenn After ein numerischer Ausdruck ist, muss es sich dabei um eine Zahl zwischen 1 und dem Wert der Count-Eigenschaft der Auflistung handeln.If After is a numeric expression, it must be a number from 1 through the value of the collection's Count property. 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.If After is a String expression, it must correspond to the key string specified when the element referred to was added to the collection. Sie können nicht gleichzeitig Before und After festlegen.You cannot specify both Before and After.

Beispiele

Im folgenden Beispiel wird die Add -Methode zum Hinzufügen child von-Instanzen einer Klasse child mit dem Namen, die eine Public Eigenschaft enthält name , zu einer family Auflistung mit dem Namen verwendet.The following example uses the Add method to add child objects - instances of a class called child containing a Public property name - to a collection called family. Um zu sehen, wie dies funktioniert, erstellen Sie eine Form mit zwei Button -Steuerelementen, und legen Text Sie deren Eigenschaften auf Add und fest ListTo see how this works, create a Form with two Button controls and set their Text properties to Add and List. Fügen Sie die child Klassendefinition und die family Deklaration dem Formular Code hinzu.Add the child class definition and the family declaration to the form code. Ändern _Click Sie die Ereignishandler für die Schaltflächen Hinzufügen und auflisten wie gezeigt.Modify the _Click event handlers for the Add and List buttons as shown. Mithilfe der Schaltfläche Hinzufügen können Sie untergeordnete Elemente hinzufügen.The Add button allows you to add children. Die Schaltfläche Liste zeigt die Namen aller untergeordneten Elemente an.The List button displays the names of all the children.

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 oder- After Argument muss auf ein vorhandenes Element der Auflistung verweisen; andernfalls tritt ein Fehler auf.The Before or After argument must refer to an existing element of the collection; otherwise, an error occurs.

Wenn das Before -Argument und das- After Argument ausgelassen werden, wird das neue-Objekt am Ende der Collection hinzugefügt.If both the Before and After arguments are omitted, the new object is added to the end of the collection.

Ein Fehler tritt auch auf, wenn ein angegebener Key Wert mit dem Schlüssel für ein vorhandenes Element der Auflistung übereinstimmt.An error also occurs if a specified Key value matches the key for an existing element of the collection.

Gilt für: