BindingSource.AddNew Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

BindingSource.cs

Új elemet ad hozzá az alapul szolgáló listához.

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

public virtual object? AddNew();

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

Public Overridable Function AddNew () As Object

Válaszok

Object

A Object létrehozott és a listához hozzáadott elem.

Megvalósítás

AddNew()

Kivételek

InvalidOperationException

A AllowNew tulajdonság be van állítva false-re.

-vagy-

Nem található nyilvános paraméter nélküli konstruktor az aktuális elemtípushoz.

Példák

Az alábbi példakód egy összetevőt használ egy BindingSource lista vezérlőelemhez való kötéséhez DataGridView . Az eseménykezelő új elemeket ad hozzá a AddingNew listához. Ez a kódpéldát a Az elem hozzáadásának testreszabása a Windows Forms BindingSource című cikkben található nagyobb példa tartalmazza.

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

Megjegyzések

A AddNew metódus új elemet ad hozzá a tulajdonság által List képviselt mögöttes listához. Ez a módszer a következő műveletek sorozatát állítja be:

1. A EndEdit rendszer automatikusan meghívja a metódust a függőben lévő szerkesztési műveletek véglegesítésére.

2. Az AddingNew esemény automatikusan fel lesz emelve. Ez az esemény programozott módon kezelhető az új elem létrehozásához. Ez az eseménykezelőben úgy érhető el, hogy a NewObject paraméter tulajdonságát az új elemre állítja System.ComponentModel.AddingNewEventArgs . Az eseményben AddingNew létrehozott új objektumnak a listában szereplő típussal megegyező típusúnak kell lennie, vagy kivétel történik.

   Ha az AddingNew esemény kezelése nem történik meg, és az alapul szolgáló lista egy IBindingList, akkor a rendszer átadja a kérést a lista metódusának IBindingList.AddNew . Ha az alapul szolgáló lista nem egy IBindingList, a rendszer automatikusan létrehozza az elemet a nyilvános paraméter nélküli konstruktoron keresztül. Az új elem mindkét esetben a lista végére kerül.

3. Az új elem azonnal hozzáadódik a belső listához, hacsak az adatforrás nem valósítja meg az interfészt IEditableObject . Ebben az esetben az új elem nem lesz véglegesített, amíg explicit hívás ICancelAddNew.EndNew nem történik, vagy amíg egy új listaművelet nem indul el. A véglegesítése előtt az új elemet vissza lehet állítani hívással CancelEdit, amely esetben az új elem elvetve lesz.

Ez a metódus az eseményt emeli ListChanged ki.

Lásd még

• AddNew()
• AddingNewEventArgs
• AddingNew
• AllowNew
• IBindingList