BindingSource.AddingNew BindingSource.AddingNew BindingSource.AddingNew BindingSource.AddingNew Event

Definition

Tritt ein, bevor der zugrunde liegenden Liste ein Element hinzugefügt wird.Occurs before an item is added to the underlying list.

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

Ausnahmen

NewObject ist nicht der gleiche Typ wie der in der Liste enthaltene Typ.NewObject is not the same type as the type contained in the list.

Beispiele

Im folgenden Codebeispiel wird eine BindingSource -Komponente verwendet, um eine Liste DataGridView an ein-Steuerelement zu binden.The following code example uses a BindingSource component to bind a list to a DataGridView control. Neue Elemente werden der Liste durch den AddingNew -Ereignishandler hinzugefügt.New items are added to the list by the AddingNew event handler. Dieses Codebeispiel ist Teil eines größeren Beispiels, das unter Vorgehensweise: Anpassen des Hinzufügens von Elementen mit demWindows Forms BindingSource.This code example is part of a larger example provided in How to: Customize Item Addition with the Windows Forms BindingSource.

// 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 ein neues-Objekt der durch die List -Eigenschaft dargestellten zugrunde liegenden Liste hinzugefügt wird.The AddingNew event occurs before a new object is added to the underlying list represented by the List property. Dieses Ereignis wird ausgelöst, nachdem AddNew die-Methode aufgerufen wurde, aber bevor das neue Element erstellt und der zugrunde liegenden Liste hinzugefügt wird.This event is fired after the AddNew method is called, but before the new item is created and added to the underlying list. Durch die Behandlung dieses Ereignisses können Programmierer benutzerdefinierte Element Erstellungs-und Einfügeverhalten bereitstellen, ohne BindingSource dass Sie von der-Klasse abgeleitet werden müssen.By handling this event, the programmer can provide custom item creation and insertion behavior without being forced to derive from the BindingSource class. Dies wird im-Ereignishandler durch Festlegen der NewObject -Eigenschaft System.ComponentModel.AddingNewEventArgs des-Parameters auf das neue Element erreicht.This is accomplished in the event handler by setting the NewObject property of the System.ComponentModel.AddingNewEventArgs parameter to the new item. Das im AddingNew Ereignis erstellte neue-Objekt muss denselben Typ aufweisen wie der in der Liste enthaltene Typ, oder es tritt eine Ausnahme auf.The new object created in the AddingNew event must be of the same type as the type contained in the list or an exception will occur. Die NewObject -Eigenschaft kann nicht festgelegt werden DataView , wenn DataTable Sie an oder gebunden ist, DataRowView da Sie der Liste keine neue hinzufügen können.You cannot set the NewObject property when bound to a DataView or DataTable because you cannot add a new DataRowView to the list.

Weitere Informationen zum Bereitstellen von benutzerdefinierten Funktionen für neue Elemente AddNew finden Sie unter der-Methode.For more information about supplying custom new item functionality, see the AddNew method. Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about handling events, see Handling and Raising Events.

Gilt für:

Siehe auch