BindingSource.AddNew Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fügt der zugrunde liegenden Liste ein neues Element hinzu.

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

Gibt zurück

Object

Das erstellte und der Liste hinzugefügte Object.

Implementiert

AddNew()

Ausnahmen

InvalidOperationException

Die AllowNew-Eigenschaft ist auf false festgelegt.

- oder -

Für den aktuellen Elementtyp konnte kein öffentlicher parameterloser Konstruktor gefunden werden.

Beispiele

Im folgenden Codebeispiel wird eine BindingSource -Komponente verwendet, um eine Liste an ein DataGridView Steuerelement zu binden. Neue Elemente werden der Liste vom AddingNew Ereignishandler hinzugefügt. Dieses Codebeispiel ist Teil eines größeren Beispiels, das unter How to: Customize Item Addition with the Windows Forms BindingSource bereitgestellt wird.

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

Hinweise

Die AddNew -Methode fügt der zugrunde liegenden Liste, die durch die List -Eigenschaft dargestellt wird, ein neues Element hinzu. Mit dieser Methode werden die folgenden Aktionen eingerichtet:

  1. Die EndEdit -Methode wird automatisch aufgerufen, um alle ausstehenden Bearbeitungsvorgänge zu committen.

  2. Das AddingNew Ereignis wird automatisch ausgelöst. Dieses Ereignis kann programmgesteuert behandelt werden, um das neue Element zu erstellen. Dies wird im Ereignishandler erreicht, indem die NewObject -Eigenschaft des System.ComponentModel.AddingNewEventArgs Parameters auf das neue Element festgelegt wird. Das im -Ereignis erstellte AddingNew neue Objekt muss denselben Typ aufweisen wie der in der Liste enthaltene Typ, andernfalls tritt eine Ausnahme auf.

    Wenn das AddingNew Ereignis nicht behandelt wird und die zugrunde liegende Liste ein IBindingListist, wird die Anforderung an die -Methode der Liste IBindingList.AddNew übergeben. Wenn die zugrunde liegende Liste keine IBindingList ist, wird das Element automatisch über seinen öffentlichen Konstruktor ohne Parameter erstellt. In beiden Fällen wird das neue Element am Ende der Liste hinzugefügt.

  3. Das neue Element wird sofort der internen Liste hinzugefügt, es sei denn, die Datenquelle implementiert die IEditableObject Schnittstelle. In diesem Fall wird ein Commit für das neue Element erst ausgeführt, wenn ein expliziter Aufruf von ICancelAddNew.EndNew erfolgt oder ein neuer Listenvorgang initiiert wird. Vor dem Commit für das neue Element kann ein Rollback ausgeführt werden, indem aufgerufen CancelEditwird. In diesem Fall wird das neue Element verworfen.

Diese Methode löst das ListChanged -Ereignis aus.

Gilt für:

Weitere Informationen