AddingNewEventHandler Delegato

Definizione

Spazio dei nomi:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Rappresenta il metodo che gestirà l'evento AddingNew.

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.

e

AddingNewEventArgs

Oggetto AddingNewEventArgs che contiene i dati dell'evento.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il delegato per gestire l'evento AddingNewEventHandlerBindingSource.AddingNew . Questo esempio di codice fa parte di un esempio più grande fornito in Procedura: Personalizzare l'aggiunta dell'elemento con l'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'evento BindingSource.AddingNew si verifica prima di aggiungere un nuovo elemento a una raccolta, in genere negli scenari di data binding. Il gestore di questo evento può fornire il nuovo elemento da aggiungere, sostituendo l'azione standard della classe di raccolta. Questa operazione viene eseguita impostando la NewObject proprietà del AddingNewEventArgs parametro e su questo nuovo elemento. In genere questo elemento deve essere di un tipo previsto dall'insieme destinatario oppure la raccolta genererà un'eccezione di tipo InvalidCastException.

Questo evento viene comunemente usato negli scenari di data binding, all'interno di classi come System.Windows.Forms.BindingSource e System.ComponentModel.BindingList<T>.

Quando si crea un delegato di AddingNewEventHandler, si identifica il metodo con cui gestire l'evento. Per associare l'evento al gestore eventi in uso, aggiungere all'evento un'istanza del delegato. Il gestore eventi viene chiamato ogni volta che si verifica l'evento, a meno che non venga rimosso il delegato. Per altre informazioni sui delegati del gestore eventi, vedere Gestione e generazione di eventi.

Metodi di estensione

GetMethodInfo(Delegate)

Ottiene un oggetto che rappresenta il metodo rappresentato dal delegato specificato.

Vedi anche

• AddingNewEventArgs
• BindingSource
• BindingList<T>