BindingSource.AddingNew Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, bevor ein Element der zugrunde liegenden Liste 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 typ, der in der Liste enthalten ist.
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 in 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 ein neues Objekt der durch die List Eigenschaft dargestellten zugrunde liegenden Liste 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 ein benutzerdefiniertes Elementerstellungs- und Einfügeverhalten bereitstellen, ohne von der BindingSource Klasse abgeleitet zu werden. 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 den gleichen Typ aufweisen wie der in der Liste enthaltene Typ, oder es tritt eine Ausnahme auf. Sie können die NewObject Eigenschaft nicht festlegen, wenn sie an eine DataView oder DataTable eine neue DataRowView Bindung an die Liste gebunden ist.
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.
