Partager via

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

Définition

Espace de noms:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll
Source:
Collection.vb
Source:
Collection.vb
Source:
Collection.vb

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 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 Before ou After doit faire référence à un élément existant de la collection ; sinon, une erreur se produit.

Si les Before deux arguments et After 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 à