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

Definition

Namnområde:
Microsoft.VisualBasic
Sammansättning:
Microsoft.VisualBasic.Core.dll
Sammansättning:
Microsoft.VisualBasic.dll
Källa:
Collection.vb
Källa:
Collection.vb
Källa:
Collection.vb
Källa:
Collection.vb
Källa:
Collection.vb

Lägger till ett element i ett Collection objekt.

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)

Parametrar

Item
Object

Required. Ett objekt av vilken typ som helst som anger elementet som ska läggas till i samlingen.

Key
String

Optional. Ett unikt String uttryck som anger en nyckelsträng som kan användas i stället för ett positionsindex för att komma åt det nya elementet i samlingen.

Before
Object

Optional. Ett uttryck som anger en relativ position i samlingen. Elementet som ska läggas till placeras i samlingen innan det element som identifieras av Before argumentet. Om Before är ett numeriskt uttryck måste det vara ett tal från 1 via värdet för samlingens Count egenskap. Om Before är ett String uttryck måste det motsvara den nyckelsträng som angavs när elementet som refererades till lades till i samlingen. Du kan inte ange både Before och After.

After
Object

Optional. Ett uttryck som anger en relativ position i samlingen. Elementet som ska läggas till placeras i samlingen efter det element som identifierats av After argumentet. Om After är ett numeriskt uttryck måste det vara ett tal från 1 via värdet för samlingens Count egenskap. Om After är ett String uttryck måste det motsvara den nyckelsträng som angavs när elementet som refererades till lades till i samlingen. Du kan inte ange både Before och After.

Exempel

I följande exempel används Add metoden för att lägga child till objekt – instanser av en klass med namnet child som innehåller en Public egenskap name – i en samling med namnet family. Om du vill se hur detta fungerar skapar du en Form med två Button kontroller och anger deras Text egenskaper till Add och List. child Lägg till klassdefinitionen och deklarationen family i formulärkoden. _Click Ändra händelsehanterarna för knapparna Lägg till och Lista enligt bilden. Med knappen Lägg till kan du lägga till underordnade objekt. Knappen Lista visar namnen på alla underordnade.

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

Kommentarer

Argumentet Before eller After måste referera till ett befintligt element i samlingen. Annars uppstår ett fel.

Om både argumenten Before och After utelämnas läggs det nya objektet till i slutet av samlingen.

Ett fel uppstår också om ett angivet Key värde matchar nyckeln för ett befintligt element i samlingen.

Gäller för