Freigeben über


BindingSource.AddingNew Ereignis

Definition

Tritt ein, bevor der zugrunde liegenden Liste ein Element hinzugefügt wird.

public:
 event System::ComponentModel::AddingNewEventHandler ^ AddingNew;
public event System.ComponentModel.AddingNewEventHandler AddingNew;
public event System.ComponentModel.AddingNewEventHandler? AddingNew;
member this.AddingNew : System.ComponentModel.AddingNewEventHandler 
Public Custom Event AddingNew As AddingNewEventHandler 

Ereignistyp

Ausnahmen

NewObject ist nicht der gleiche Typ wie der in der Liste enthaltene Typ.

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.

// This event handler provides custom item-creation behavior.
void OnCustomersBindingSourceAddingNew(Object^ sender, 
    AddingNewEventArgs^ e)
{
    e->NewObject = DemoCustomer::CreateNewCustomer();
}
// This event handler provides custom item-creation behavior.
void customersBindingSource_AddingNew(
    object sender, 
    AddingNewEventArgs e)
{
    e.NewObject = DemoCustomer.CreateNewCustomer();
}
' This event handler provides custom item-creation behavior.
 Private Sub customersBindingSource_AddingNew( _
 ByVal sender As Object, _
 ByVal e As AddingNewEventArgs) _
 Handles customersBindingSource.AddingNew

     e.NewObject = DemoCustomer.CreateNewCustomer()

 End Sub

Hinweise

Das AddingNew Ereignis tritt auf, bevor der zugrunde liegenden Liste, die durch die List -Eigenschaft dargestellt wird, ein neues Objekt hinzugefügt wird. Dieses Ereignis wird ausgelöst, nachdem die AddNew -Methode aufgerufen wurde, aber bevor das neue Element erstellt und der zugrunde liegenden Liste hinzugefügt wird. Durch die Behandlung dieses Ereignisses kann der Programmierer benutzerdefiniertes Elementerstellungs- und Einfügeverhalten bereitstellen, ohne gezwungen zu werden, von der BindingSource -Klasse abzuleiten. 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. Sie können die NewObject -Eigenschaft nicht festlegen, wenn sie an oder DataViewDataTable gebunden ist, da Sie der Liste keine neue DataRowView hinzufügen können.

Weitere Informationen zum Bereitstellen benutzerdefinierter neuer Elementfunktionen finden Sie in der AddNew -Methode. Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Gilt für:

Weitere Informationen