BindingSource.AddNew Metode

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

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 daftar dasar.

public:
 virtual System::Object ^ AddNew();

public virtual object AddNew ();

public virtual object? AddNew ();

abstract member AddNew : unit -> obj
override this.AddNew : unit -> obj

Public Overridable Function AddNew () As Object

Mengembalikan

Object

Object yang dibuat dan ditambahkan ke daftar.

Penerapan

AddNew()

Pengecualian

InvalidOperationException

Properti AllowNew diatur ke false.

-atau-

Konstruktor tanpa parameter publik tidak dapat ditemukan untuk tipe item saat ini.

Contoh

Contoh kode berikut menggunakan BindingSource komponen untuk mengikat daftar ke DataGridView kontrol. Item baru ditambahkan ke daftar oleh penanganan AddingNew aktivitas. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan dalam Cara: Menyesuaikan Penambahan Item dengan Formulir Windows BindingSource.

private:
   
    void OnMainFormLoad(Object^ sender, EventArgs^ e)
    {
        // Add a DemoCustomer to cause a row to be displayed.
        this->customersBindingSource->AddNew();
          
        // Bind the BindingSource to the DataGridView 
        // control's DataSource.
        this->customersDataGridView->DataSource = 
            this->customersBindingSource;
    }

private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Add a DemoCustomer to cause a row to be displayed.
    this.customersBindingSource.AddNew();

    // Bind the BindingSource to the DataGridView 
    // control's DataSource.
    this.customersDataGridView.DataSource = 
        this.customersBindingSource;
}

Private Sub Form1_Load( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs)

    ' Add a DemoCustomer to cause a row to be displayed.
    Me.customersBindingSource.AddNew()

    ' Bind the BindingSource to the DataGridView 
    ' control's DataSource.
    Me.customersDataGridView.DataSource = Me.customersBindingSource

End Sub

Keterangan

Metode AddNew menambahkan item baru ke daftar dasar yang diwakili oleh List properti . Metode ini menyiapkan serangkaian tindakan berikut:

Metode EndEdit ini secara otomatis dipanggil untuk menerapkan operasi pengeditan yang tertunda.
Peristiwa AddingNew dinaikkan secara otomatis. Kejadian ini dapat ditangani secara terprogram untuk membuat item baru. Ini dicapai di penanganan aktivitas dengan mengatur NewObject properti System.ComponentModel.AddingNewEventArgs parameter ke item baru. Objek baru yang dibuat dalam AddingNew peristiwa harus memiliki jenis yang sama dengan jenis yang terkandung dalam daftar atau pengecualian akan terjadi.

AddingNew Jika peristiwa tidak ditangani, dan daftar yang mendasar adalah IBindingList, maka permintaan diteruskan ke metode daftarIBindingList.AddNew. Jika daftar yang mendasar bukan IBindingList, item secara otomatis dibuat melalui konstruktor tanpa parameter publiknya. Dalam kedua kasus, item baru ditambahkan ke akhir daftar.
Item baru segera ditambahkan ke daftar internal kecuali sumber data mengimplementasikan IEditableObject antarmuka. Dalam hal ini, item baru tidak dilakukan sampai panggilan eksplisit ke ICancelAddNew.EndNew dilakukan atau sampai operasi daftar baru dimulai. Sebelum diterapkan, item baru dapat digulung balik dengan memanggil CancelEdit, dalam hal ini item baru dibuang.

Metode ini meningkatkan ListChanged peristiwa.

Berlaku untuk

Bagikan melalui