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

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

Collection.vb

Dodaje element do Collection obiektu.

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)

Parametry

Item

Object

Wymagane. Obiekt dowolnego typu, który określa element do dodania do kolekcji.

Key

String

Opcjonalny. Unikatowe String wyrażenie określające ciąg klucza, którego można użyć zamiast indeksu pozycyjnego w celu uzyskania dostępu do tego nowego elementu w kolekcji.

Before

Object

Opcjonalny. Wyrażenie, które określa położenie względne w kolekcji. Element do dodania jest umieszczany w kolekcji przed elementem Before zidentyfikowanym przez argument. Jeśli Before jest wyrażeniem liczbowym, musi być liczbą z zakresu od 1 do wartości właściwości kolekcji Count . Jeśli Before jest wyrażeniem String , musi odpowiadać ciągowi klucza określonemu podczas dodawania elementu do kolekcji. Nie można określić wartości i BeforeAfter.

After

Object

Opcjonalny. Wyrażenie, które określa położenie względne w kolekcji. Element do dodania jest umieszczany w kolekcji po elememencie zidentyfikowanym After przez argument. Jeśli After jest wyrażeniem liczbowym, musi być liczbą z zakresu od 1 do wartości właściwości kolekcji Count . Jeśli After jest wyrażeniem String , musi odpowiadać ciągowi klucza określonemu podczas dodawania elementu do kolekcji. Nie można określić wartości i BeforeAfter.

Przykłady

W poniższym przykładzie Add użyto metody , aby dodać child obiekty — wystąpienia klasy o nazwie child zawierającej Public właściwość name — do kolekcji o nazwie family. Aby zobaczyć, jak to działa, utwórz obiekt z dwoma FormButton kontrolkami i ustaw ich Text właściwości na Add i List. Dodaj definicję klasy i deklarację childfamily do kodu formularza. Zmodyfikuj _Click programy obsługi zdarzeń dla przycisków Dodaj i Wyświetl , jak pokazano. Przycisk Dodaj umożliwia dodawanie elementów podrzędnych. Przycisk Lista wyświetla nazwy wszystkich elementów podrzędnych.

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

Uwagi

Argument or After musi odwoływać się do istniejącego elementu kolekcji. W Before przeciwnym razie wystąpi błąd.

Jeśli oba Before argumenty i After zostaną pominięte, nowy obiekt zostanie dodany na końcu kolekcji.

Występuje również błąd, jeśli określona Key wartość jest zgodna z kluczem dla istniejącego elementu kolekcji.