AddingNewEventHandler Delegat

Definition

Stellt die Methode zur Behandlung des AddingNew-Ereignisses dar.Represents the method that will handle the AddingNew event.

public delegate void AddingNewEventHandler(System::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.The source of the event, typically a data container or data-bound collection.

e
AddingNewEventArgs

Ein AddingNewEventArgs, das die Ereignisdaten enthält.A AddingNewEventArgs that contains the event data.

Vererbung
AddingNewEventHandler

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der AddingNewEventHandler -Delegat verwendet BindingSource.AddingNew wird, um das-Ereignis zu behandeln.The following code example demonstrates how to use the AddingNewEventHandler delegate to handle the BindingSource.AddingNew event. 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 BindingSource.AddingNew Ereignis tritt auf, bevor ein neues Element zu einer Auflistung hinzugefügt wird (in der Regel in Daten Bindungs Szenarien).The BindingSource.AddingNew event occurs prior to adding a new item to a collection, typically in data-binding scenarios. Der Handler dieses Ereignisses kann das neue Element bereitstellen, das hinzugefügt werden soll, wobei die Standardaktion der Auflistungs Klasse überschrieben wird.The handler of this event can supply the new item to be added, overriding the standard action of the collection class. Dies wird erreicht, indem die NewObject -Eigenschaft AddingNewEventArgs des- e Parameters auf dieses neue Element festgelegt wird.This is accomplished by setting the NewObject property of the AddingNewEventArgs parameter e to this new item. In der Regel muss dieses Element von einem Typ sein, der von der Empfänger Auflistung erwartet wird, oder die Auflistung löst InvalidCastExceptioneine Ausnahme vom Typ aus.Typically this item must be of a type expected by the recipient collection, or the collection will throw an exception of type InvalidCastException.

Dieses Ereignis wird häufig in Daten Bindungs Szenarien innerhalb von Klassen wie System.Windows.Forms.BindingSource und System.ComponentModel.BindingList<T>verwendet.This event is commonly used in data-binding scenarios, within classes such as System.Windows.Forms.BindingSource and System.ComponentModel.BindingList<T>.

Beim Erstellen eines AddingNewEventHandler-Delegaten geben Sie die Methode für die Ereignisbehandlung an.When you create an AddingNewEventHandler delegate, you identify the method that will handle the event. Um dem Ereignishandler das Ereignis zuzuordnen, fügen Sie dem Ereignis eine Instanz des Delegaten hinzu.To associate the event with your event handler, add an instance of the delegate to the event. Der Ereignishandler wird bei jedem Eintreten des Ereignisses aufgerufen, sofern der Delegat nicht entfernt wird.The event handler is called whenever the event occurs, unless you remove the delegate. Weitere Informationen zu Ereignishandlerdelegaten finden Sie unter behandeln und Auswerfen von Ereignissen.For more information about event-handler delegates, see Handling and Raising Events.

Erweiterungsmethoden

GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.Gets an object that represents the method represented by the specified delegate.

Gilt für:

Siehe auch