BindingSource.AddingNew Evento

Definizione

Si verifica prima dell'aggiunta di un elemento all'elenco sottostante.

public:
 event System::ComponentModel::AddingNewEventHandler ^ AddingNew;
public event System.ComponentModel.AddingNewEventHandler AddingNew;
public event System.ComponentModel.AddingNewEventHandler? AddingNew;
member this.AddingNew : System.ComponentModel.AddingNewEventHandler 
Public Custom Event AddingNew As AddingNewEventHandler 

Tipo evento

Eccezioni

Il tipo di proprietà NewObject è diverso da quello contenuto nell'elenco.

Esempio

Nell'esempio di codice seguente viene usato un componente per associare un BindingSource elenco a un DataGridView controllo. I nuovi elementi vengono aggiunti all'elenco AddingNew dal gestore eventi. 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 AddingNew si verifica prima dell'aggiunta di un nuovo oggetto all'elenco List sottostante rappresentato dalla proprietà . Questo evento viene attivato dopo la chiamata del AddNew metodo, ma prima che venga creato il nuovo elemento e aggiunto all'elenco sottostante. Gestendo questo evento, il programmatore può fornire il comportamento di creazione e inserimento di elementi personalizzati senza essere costretto a derivare dalla BindingSource classe. Questa operazione viene eseguita nel gestore eventi impostando la NewObject proprietà del System.ComponentModel.AddingNewEventArgs parametro sul nuovo elemento. Il nuovo oggetto creato nell'evento AddingNew deve essere dello stesso tipo del tipo contenuto nell'elenco o si verificherà un'eccezione. Non è possibile impostare la NewObject proprietà quando è associata a o DataViewDataTable perché non è possibile aggiungere un nuovo DataRowView oggetto all'elenco.

Per altre informazioni sulla fornitura di funzionalità personalizzate di nuovi elementi, vedere il AddNew metodo . Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.

Si applica a

Vedi anche