AddingNewEventArgs Classe

Definizione

public ref class AddingNewEventArgs : EventArgs

public class AddingNewEventArgs : EventArgs

type AddingNewEventArgs = class
    inherit EventArgs

Public Class AddingNewEventArgs
Inherits EventArgs

Ereditarietà

Object

EventArgs

AddingNewEventArgs

Esempio

Nell'esempio di codice seguente viene illustrato come usare la AddingNewEventArgs classe 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

La AddingNewEventArgs classe fornisce dati per l'evento BindingSource.AddingNew , che segnala che un elemento sta per essere aggiunto a una raccolta. L'evento fornisce al programmatore, all'interno del gestore eventi AddingNewEventHandler, l'opzione di fornire il nuovo oggetto impostando la NewObject proprietà su questo nuovo elemento. Se questa proprietà non è impostata, la raccolta userà in genere il costruttore senza parametri del tipo appropriato per costruire un nuovo elemento. In entrambi i casi, il nuovo elemento verrà aggiunto alla raccolta.

Se la raccolta implementa anche l'interfaccia ICancelAddNew , l'elemento verrà aggiunto provvisoriamente, in attesa di un commit o un rollback successivo.

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

Per altre informazioni su come gestire gli eventi, vedere Gestione e generazione di eventi.

Vedi anche

• AddingNewEventHandler
• AddingNew
• ICancelAddNew