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

Definisi

Ruang nama:

Microsoft.VisualBasic

Rakitan:

Microsoft.VisualBasic.Core.dll

Sumber:

Collection.vb

Menambahkan elemen ke Collection objek.

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)

Parameter

Item

Object

Wajib diisi. Objek dari jenis apa pun yang menentukan elemen untuk ditambahkan ke koleksi.

Key

String

Pilihan. Ekspresi unik String yang menentukan string kunci yang dapat digunakan alih-alih indeks posisi untuk mengakses elemen baru ini dalam koleksi.

Before

Object

Pilihan. Ekspresi yang menentukan posisi relatif dalam koleksi. Elemen yang akan ditambahkan ditempatkan dalam koleksi sebelum elemen diidentifikasi oleh Before argumen . Jika Before adalah ekspresi numerik, harus berupa angka dari 1 hingga nilai properti koleksi Count . Jika Before adalah String ekspresi, itu harus sesuai dengan string kunci yang ditentukan ketika elemen yang dirujuk ditambahkan ke koleksi. Anda tidak dapat menentukan dan BeforeAfter.

After

Object

Pilihan. Ekspresi yang menentukan posisi relatif dalam koleksi. Elemen yang akan ditambahkan ditempatkan dalam koleksi setelah elemen yang diidentifikasi oleh After argumen . Jika After adalah ekspresi numerik, harus berupa angka dari 1 hingga nilai properti koleksi Count . Jika After adalah String ekspresi, itu harus sesuai dengan string kunci yang ditentukan ketika elemen yang dirujuk ditambahkan ke koleksi. Anda tidak dapat menentukan dan BeforeAfter.

Contoh

Contoh berikut menggunakan Add metode untuk menambahkan child objek - instans kelas yang disebut child berisi Public properti name - ke koleksi yang disebut family. Untuk melihat cara kerjanya, buat Form dengan dua Button kontrol dan atur propertinya Text ke Add dan List. child Tambahkan definisi kelas dan family deklarasi ke kode formulir. Ubah penanganan _Click aktivitas untuk tombol Tambahkan dan Daftar seperti yang ditunjukkan. Tombol Tambahkan memungkinkan Anda menambahkan anak- anak. Tombol Daftar menampilkan nama semua turunan.

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

Keterangan

Argumen Before atau After harus merujuk ke elemen koleksi yang ada; jika tidak, kesalahan terjadi.

Jika argumen dan After dihilangkanBefore, objek baru ditambahkan ke akhir koleksi.

Kesalahan juga terjadi jika nilai yang ditentukan Key cocok dengan kunci untuk elemen koleksi yang ada.