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

Référence

Définition

Espace de noms:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute un élément à un objet Collection.

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)

Paramètres

Item: Object

Obligatoire. Objet d'un type quelconque qui spécifie l'élément à ajouter à la collection.

Key: String

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

Before: Object

Optionnel. 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. Si Before est une expression numérique, ce doit être un nombre entre 1 et la valeur de la propriété Count de la collection. Si Before est une expression String, il doit correspondre à la chaîne clé spécifiée au moment où l'élément auquel il est fait référence a été ajouté à la collection. Vous ne pouvez pas spécifier Before et After.

After: Object

Optionnel. 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. Si After est une expression numérique, ce doit être un nombre entre 1 et la valeur de la propriété Count de la collection. Si After est une expression String, il doit correspondre à la chaîne clé spécifiée au moment où l'élément auquel il est fait référence a été ajouté à la collection. Vous ne pouvez pas spécifier 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 child définition de 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

Le 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.

S’applique à