Freigeben über


AddingNewEventHandler Delegat

Definition

Stellt die Methode zur Behandlung des AddingNew-Ereignisses dar.

public delegate void AddingNewEventHandler(System::Object ^ sender, AddingNewEventArgs ^ e);
public delegate void AddingNewEventHandler(object sender, AddingNewEventArgs e);
public delegate void AddingNewEventHandler(object? sender, AddingNewEventArgs e);
type AddingNewEventHandler = delegate of obj * AddingNewEventArgs -> unit
Public Delegate Sub AddingNewEventHandler(sender As Object, e As AddingNewEventArgs)

Parameter

sender
Object

Die Quelle des Ereignisses, i. d. R. ein Datencontainer oder eine datengebundene Auflistung.

e
AddingNewEventArgs

Ein AddingNewEventArgs, das die Ereignisdaten enthält.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie den AddingNewEventHandler Delegat verwenden, um das BindingSource.AddingNew Ereignis zu behandeln. Dieses Codebeispiel ist Teil eines größeren Beispiels 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 BindingSource.AddingNew Ereignis tritt vor dem Hinzufügen eines neuen Elements zu einer Sammlung auf, in der Regel in Datenbindungsszenarien. Der Handler dieses Ereignisses kann das hinzuzufügende neue Element bereitstellen und die Standardaktion der Auflistungsklasse außer Kraft setzen. Dies wird erreicht, indem die NewObject Eigenschaft des AddingNewEventArgs Parameters e auf dieses neue Element festgelegt wird. In der Regel muss dieses Element von einem Typ sein, der von der Empfängerauflistung erwartet wird. Andernfalls löst die Auflistung eine Ausnahme vom Typ aus InvalidCastException.

Dieses Ereignis wird häufig in Datenbindungsszenarien in Klassen wie System.Windows.Forms.BindingSource und System.ComponentModel.BindingList<T>verwendet.

Beim Erstellen eines AddingNewEventHandler-Delegaten geben Sie die Methode für die Ereignisbehandlung an. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird. Weitere Informationen zu Ereignishandlerdelegierten finden Sie unter Behandeln und Auslösen von Ereignissen.

Erweiterungsmethoden

GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.

Gilt für:

Weitere Informationen