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

Definizione

Spazio dei nomi:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Aggiunge un elemento a un Collection oggetto .

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)

Parametri

Item
Object

Required. Oggetto di qualsiasi tipo che specifica l'elemento da aggiungere alla raccolta.

Key
String

Optional. Espressione univoca String che specifica una stringa di chiave che può essere utilizzata anziché un indice posizionale per accedere a questo nuovo elemento nella raccolta.

Before
Object

Optional. Espressione che specifica una posizione relativa nella raccolta. L'elemento da aggiungere viene inserito nella raccolta prima dell'elemento identificato dall'argomento Before . Se Before è un'espressione numerica, deve essere un numero compreso tra 1 e il valore della proprietà della Count raccolta. Se Before è un'espressione String , deve corrispondere alla stringa di chiave specificata quando l'elemento a cui si fa riferimento è stato aggiunto alla raccolta. Non è possibile specificare sia Before che After.

After
Object

Optional. Espressione che specifica una posizione relativa nella raccolta. L'elemento da aggiungere viene inserito nella raccolta dopo l'elemento identificato dall'argomento After . Se After è un'espressione numerica, deve essere un numero compreso tra 1 e il valore della proprietà della Count raccolta. Se After è un'espressione String , deve corrispondere alla stringa di chiave specificata quando l'elemento a cui si fa riferimento è stato aggiunto alla raccolta. Non è possibile specificare sia Before che After.

Esempio

Nell'esempio seguente viene utilizzato il Add metodo per aggiungere child oggetti , istanze di una classe denominata contenente una Public proprietà name , a una raccolta denominata childfamily. Per vedere come funziona, creare un Form oggetto con due Button controlli e impostarne Text le proprietà su Add e List. Aggiungere la definizione della child classe e la family dichiarazione al codice del modulo. Modificare i _Click gestori eventi per i pulsanti Aggiungi ed Elenco come illustrato. Il pulsante Aggiungi consente di aggiungere elementi figlio. Il pulsante Elenco visualizza i nomi di tutti gli elementi figlio.

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

Commenti

L'argomento Before o After deve fare riferimento a un elemento esistente della raccolta. In caso contrario, si verifica un errore.

Se entrambi gli Before argomenti e After vengono omessi, il nuovo oggetto viene aggiunto alla fine della raccolta.

Si verifica anche un errore se un valore specificato Key corrisponde alla chiave per un elemento esistente della raccolta.

Si applica a