AddingNewEventHandler AddingNewEventHandler AddingNewEventHandler AddingNewEventHandler Delegate

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 Object Object 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 AddingNewEventArgs AddingNewEventArgs AddingNewEventArgs

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

Ereditarietà
AddingNewEventHandlerAddingNewEventHandlerAddingNewEventHandlerAddingNewEventHandler

Esempi

Esempio di codice seguente viene illustrato come utilizzare il AddingNewEventHandler delegato per gestire il BindingSource.AddingNew evento.The following code example demonstrates how to use the AddingNewEventHandler delegate to handle the BindingSource.AddingNew event. Questo esempio di codice è parte di un esempio più esaustivo disponibile come: Personalizzare l'aggiunta di elementi con BindingSource Windows Form.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

Il BindingSource.AddingNew evento si verifica prima di aggiungere un nuovo elemento a una raccolta, in genere in scenari di data binding.The BindingSource.AddingNew event occurs prior to adding a new item to a collection, typically in data-binding scenarios. Il gestore dell'evento può fornire il nuovo elemento da aggiungere, l'azione standard della classe di raccolta viene sottoposto a override.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 il NewObject proprietà del AddingNewEventArgs parametro e a 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 o la raccolta verrà generata 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 utilizzato, ad esempio in scenari di data binding, all'interno delle classi 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 altre informazioni sui delegati del gestore eventi, vedere la gestione e generazione di eventi.For more information about event-handler delegates, see Handling and Raising Events.

Metodi di estensione

GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate) 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