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

Definitie

Naamruimte:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Hiermee voegt u een element toe aan een Collection object.

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)

Parameters

Item
Object

Required. Een object van elk type dat het element aangeeft dat moet worden toegevoegd aan de verzameling.

Key
String

Optional. Een unieke String expressie waarmee een sleuteltekenreeks wordt opgegeven die kan worden gebruikt in plaats van een positionele index voor toegang tot dit nieuwe element in de verzameling.

Before
Object

Optional. Een expressie die een relatieve positie in de verzameling aangeeft. Het element dat moet worden toegevoegd, wordt in de verzameling geplaatst voordat het element wordt geïdentificeerd door het Before argument. Als Before dit een numerieke expressie is, moet dit een getal van 1 tot en met de waarde van de eigenschap van de verzameling Count zijn. Als Before dit een String expressie is, moet deze overeenkomen met de sleuteltekenreeks die is opgegeven wanneer het element waarnaar wordt verwezen, is toegevoegd aan de verzameling. U kunt zowel als BeforeAfter.

After
Object

Optional. Een expressie die een relatieve positie in de verzameling aangeeft. Het element dat moet worden toegevoegd, wordt in de verzameling geplaatst nadat het element is geïdentificeerd door het After argument. Als After dit een numerieke expressie is, moet dit een getal van 1 tot en met de waarde van de eigenschap van de verzameling Count zijn. Als After dit een String expressie is, moet deze overeenkomen met de sleuteltekenreeks die is opgegeven wanneer het element waarnaar wordt verwezen, is toegevoegd aan de verzameling. U kunt zowel als BeforeAfter.

Voorbeelden

In het volgende voorbeeld wordt de methode gebruikt om objecten toe te voegen child - exemplaren van een klasse die een Public eigenschap name bevat child - aan een verzameling met de Add naam family. Als u wilt zien hoe dit werkt, maakt u een met twee Button besturingselementen en stelt u de Text bijbehorende eigenschappen in Add op en List.Form Voeg de child klassedefinitie en de family declaratie toe aan de formuliercode. Wijzig de _Click gebeurtenis-handlers voor de knoppen Toevoegen en Lijst , zoals wordt weergegeven. Met de knop Toevoegen kunt u onderliggende items toevoegen. Met de knop Lijst worden de namen van alle onderliggende items weergegeven.

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

Opmerkingen

Het Before of After argument moet verwijzen naar een bestaand element van de verzameling. Anders treedt er een fout op.

Als zowel de als After de Before argumenten worden weggelaten, wordt het nieuwe object toegevoegd aan het einde van de verzameling.

Er treedt ook een fout op als een opgegeven Key waarde overeenkomt met de sleutel voor een bestaand element van de verzameling.

Van toepassing op