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

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

Collection.vb

Aggiunge un elemento all'oggetto Collection.

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

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

Key

String

facoltativo. Espressione String univoca che specifica una stringa chiave utilizzabile al posto di un indice di posizione per accedere a questo nuovo elemento della raccolta.

Before

Object

facoltativo. 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à Count della raccolta. Se Before è un'espressione String, deve corrispondere alla stringa della chiave specificata quando l'elemento a cui viene fatto riferimento è stato aggiunto alla raccolta. Non è possibile specificare sia Before che After.

After

Object

facoltativo. 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à Count della raccolta. Se After è un'espressione String, deve corrispondere alla stringa della chiave specificata quando l'elemento a cui viene fatto riferimento è stato aggiunto alla raccolta. Non è possibile specificare sia Before che After.

Esempio

Nell'esempio seguente viene usato 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 oggetto Form con due Button controlli e impostare le relative Text proprietà su Add e List. Aggiungere la definizione della classe e la childfamily dichiarazione al codice del modulo. Modificare i gestori eventi per i _Click pulsanti Aggiungi e 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 dell'insieme.

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