AddingNewEventHandler Delegato

Definizione

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)

Parametri

Esempio

Nell'esempio di codice seguente viene illustrato come usare il AddingNewEventHandler delegato per gestire l'evento BindingSource.AddingNew . Questo esempio di codice fa parte di un esempio più ampio fornito in Procedura: Personalizzare l'aggiunta di elementi con BindingSource di Windows Form.

// 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, ignorando 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 dalla raccolta destinatari 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 AddingNewEventHandler delegato, si identifica il metodo che gestirà l'evento. Per associare l'evento al gestore eventi, aggiungere un'istanza del delegato all'evento. Il gestore eventi viene chiamato ogni volta che si verifica l'evento, a meno che non si rimuovono il delegato. Per altre informazioni sui delegati del gestore eventi, vedere Gestione e generazione di eventi.

Vedi anche

• AddingNewEventArgs
• BindingSource
• BindingList<T>