AddingNewEventHandler Delegato

Definizione

Rappresenta il metodo che gestirà l'evento AddingNew.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)

Parametri

sender
Object

Origine dell'evento, in genere un contenitore di dati o un insieme associato ai dati.The source of the event, typically a data container or data-bound collection.

e
AddingNewEventArgs

Oggetto AddingNewEventArgs che contiene i dati dell'evento.A AddingNewEventArgs that contains the event data.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il AddingNewEventHandler delegato per gestire l' BindingSource.AddingNew evento.The following code example demonstrates how to use the AddingNewEventHandler delegate to handle the BindingSource.AddingNew event. Questo esempio di codice fa parte di un esempio più ampio fornito in procedura: personalizzare l'aggiunta di elementi con il Windows 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

Commenti

L' BindingSource.AddingNew evento si verifica prima dell'aggiunta di un nuovo elemento a una raccolta, in genere negli scenari di associazione dati.The BindingSource.AddingNew event occurs prior to adding a new item to a collection, typically in data-binding scenarios. Il gestore di questo evento può fornire il nuovo elemento da aggiungere, eseguendo l'override dell'azione standard della classe Collection.The handler of this event can supply the new item to be added, overriding the standard action of the collection class. Questa operazione viene eseguita impostando la NewObject proprietà del AddingNewEventArgs parametro e su questo nuovo elemento.This is accomplished by setting the NewObject property of the AddingNewEventArgs parameter e to this new item. In genere, questo elemento deve essere di un tipo previsto dalla raccolta di destinatari oppure la raccolta genererà un'eccezione di tipo InvalidCastException .Typically this item must be of a type expected by the recipient collection, or the collection will throw an exception of type InvalidCastException.

Questo evento viene comunemente usato negli scenari di associazione dati, all'interno di classi quali System.Windows.Forms.BindingSource e System.ComponentModel.BindingList<T> .This event is commonly used in data-binding scenarios, within classes such as System.Windows.Forms.BindingSource and System.ComponentModel.BindingList<T>.

Quando si crea un delegato di AddingNewEventHandler, si identifica il metodo con cui gestire l'evento.When you create an AddingNewEventHandler delegate, you identify the method that will handle the event. Per associare l'evento al gestore eventi in uso, aggiungere all'evento un'istanza del delegato.To associate the event with your event handler, add an instance of the delegate to the event. Il gestore eventi viene chiamato ogni volta che si verifica l'evento, a meno che non venga rimosso il delegato.The event handler is called whenever the event occurs, unless you remove the delegate. Per ulteriori informazioni sui delegati del gestore eventi, vedere gestione e generazione di eventi.For more information about event-handler delegates, see Handling and Raising Events.

Metodi di estensione

GetMethodInfo(Delegate)

Ottiene un oggetto che rappresenta il metodo rappresentato dal delegato specificato.Gets an object that represents the method represented by the specified delegate.

Si applica a

Vedi anche