Collection.Add(Object, String, Object, Object) Método

Definición

Espacio de nombres:
Microsoft.VisualBasic
Ensamblado:
Microsoft.VisualBasic.dll

Agrega un elemento a un Collection objeto .

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)

Parámetros

Item
Object

Required. Objeto de cualquier tipo que especifique el elemento que se va a agregar a la colección.

Key
String

Optional. Expresión única String que especifica una cadena de clave que se puede usar en lugar de un índice posicional para tener acceso a este nuevo elemento de la colección.

Before
Object

Optional. Una expresión que especifica una posición relativa en la colección. El elemento que se va a agregar se coloca en la colección antes del elemento identificado por el Before argumento . Si Before es una expresión numérica, debe ser un número comprendido entre 1 y el valor de la propiedad de Count la colección. Si Before es una String expresión, debe corresponder a la cadena de clave especificada cuando se agregó el elemento al que se hace referencia a la colección. No se pueden especificar y BeforeAfter.

After
Object

Optional. Una expresión que especifica una posición relativa en la colección. El elemento que se va a agregar se coloca en la colección después del elemento identificado por el After argumento . Si After es una expresión numérica, debe ser un número comprendido entre 1 y el valor de la propiedad de Count la colección. Si After es una String expresión, debe corresponder a la cadena de clave especificada cuando el elemento al que se hace referencia se agregó a la colección. No se pueden especificar y BeforeAfter.

Ejemplos

En el ejemplo siguiente se usa el Add método para agregar child objetos ( instancias de una clase denominada child que contiene una Public propiedad name ) a una colección denominada family. Para ver cómo funciona esto, cree un Form con dos Button controles y establezca sus Text propiedades Add en y List. Agregue la child definición de clase y la family declaración al código de formulario. Modifique los _Click controladores de eventos para los botones Agregar y Enumerar como se muestra. El botón Agregar permite agregar elementos secundarios. El botón Lista muestra los nombres de todos los elementos secundarios.

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

Comentarios

El Before argumento o After debe hacer referencia a un elemento existente de la colección; de lo contrario, se produce un error.

Si se omiten los Before argumentos y After , el nuevo objeto se agrega al final de la colección.

También se produce un error si un valor especificado Key coincide con la clave de un elemento existente de la colección.

Se aplica a