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

Définition

Espace de noms:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.dll

Ajoute un élément à un Collection objet.

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)

Paramètres

Item

Object

Required. Objet de tout type qui spécifie l’élément à ajouter à la collection.

Key

String

Optional. Expression unique String qui spécifie une chaîne de clé qui peut être utilisée au lieu d’un index positionnel pour accéder à ce nouvel élément de la collection.

Before

Object

Optional. Expression qui spécifie une position relative dans la collection. L’élément à ajouter est placé dans la collection avant l’élément identifié par l’argument Before . S’il Before s’agit d’une expression numérique, il doit s’agir d’un nombre compris entre 1 et la valeur de la propriété de Count la collection. S’il Before s’agit d’une String expression, elle doit correspondre à la chaîne de clé spécifiée lorsque l’élément référencé a été ajouté à la collection. Vous ne pouvez pas spécifier les deux Before et After.

After

Object

Optional. Expression qui spécifie une position relative dans la collection. L’élément à ajouter est placé dans la collection après l’élément identifié par l’argument After . S’il After s’agit d’une expression numérique, il doit s’agir d’un nombre compris entre 1 et la valeur de la propriété de Count la collection. S’il After s’agit d’une String expression, elle doit correspondre à la chaîne de clé spécifiée lorsque l’élément référencé a été ajouté à la collection. Vous ne pouvez pas spécifier les deux Before et After.

Exemples

L’exemple suivant utilise la Add méthode pour ajouter child des objets - instances d’une classe appelée child contenant une Public propriété name - à une collection appelée family. Pour voir comment cela fonctionne, créez un Form avec deux Button contrôles et définissez leurs Text propriétés sur Add et List. Ajoutez la définition de child classe et la family déclaration au code de formulaire. Modifiez les _Click gestionnaires d’événements pour les boutons Ajouter et Liste comme indiqué. Le bouton Ajouter vous permet d’ajouter des enfants. Le bouton Liste affiche les noms de tous les enfants.

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

Remarques

L’argument ou After l’argument Before doit faire référence à un élément existant de la collection ; sinon, une erreur se produit.

Si les arguments et After les Before arguments sont omis, le nouvel objet est ajouté à la fin de la collection.

Une erreur se produit également si une valeur spécifiée Key correspond à la clé d’un élément existant de la collection.