BindingList<T>.AddNew Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menambahkan item baru ke koleksi.
public:
T AddNew();public T AddNew();member this.AddNew : unit -> 'TPublic Function AddNew () As TMengembalikan
Item ditambahkan ke daftar.
Pengecualian
Properti AllowNew disetel ke false.
-atau-
Konstruktor tanpa parameter publik tidak dapat ditemukan untuk tipe item saat ini.
Contoh
Contoh kode berikut menunjukkan cara menggunakan AddNew metode . BindingList<T>. Untuk contoh lengkapnya, lihat BindingList<T> topik gambaran umum kelas.
// Add the new part unless the part number contains
// spaces. In that case cancel the add.
void button1_Click(object sender, EventArgs e)
{
Part newPart = listOfParts.AddNew();
if (newPart.PartName.Contains(' '))
{
_ = MessageBox.Show("Part names cannot contain spaces.");
listOfParts.CancelNew(listOfParts.IndexOf(newPart));
}
else
{
textBox2.Text = randomNumber.Next(9999).ToString();
textBox1.Text = "Enter part name";
}
}
' Add the new part unless the part number contains
' spaces. In that case cancel the add.
Private Sub button1_Click(ByVal sender As Object, _
ByVal e As EventArgs) Handles button1.Click
Dim newPart As Part = listOfParts.AddNew()
If newPart.PartName.Contains(" ") Then
MessageBox.Show("Part names cannot contain spaces.")
listOfParts.CancelNew(listOfParts.IndexOf(newPart))
Else
textBox2.Text = randomNumber.Next(9999).ToString()
textBox1.Text = "Enter part name"
End If
End Sub
Keterangan
Metode AddNew menambahkan item baru ke koleksi yang diwakili oleh Items properti . Untuk menambahkan item baru, logika berikut digunakan:
Acara AddingNew dinaikkan secara otomatis.
Kejadian ini dapat ditangani secara terprogram untuk membangun item kustom baru. Ini dicapai dalam penanganan aktivitas dengan mengatur NewObject properti AddingNewEventArgs parameter ke item baru.
Jika tidak, item baru secara otomatis dibuat melalui konstruktor tanpa parameter publiknya.
Posisi item baru dilacak, tetapi tidak ditambahkan ke daftar hingga salah satu kondisi berikut terpenuhi:
Item secara eksplisit dilakukan oleh panggilan ke EndNew.
Item diterapkan secara implisit oleh beberapa operasi lain yang mengubah konten daftar, seperti penyisipan atau penghapusan item.
Sebaliknya, memanggil CancelNew metode sebelum item diterapkan akan menyebabkan item baru dibuang.
Metode ini meningkatkan ListChanged peristiwa ketika item baru diterapkan.
