BindingSource.AddingNew Zdarzenie

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Występuje przed dodaniu elementu do listy bazowej.

public:
 event System::ComponentModel::AddingNewEventHandler ^ AddingNew;

public event System.ComponentModel.AddingNewEventHandler AddingNew;

member this.AddingNew : System.ComponentModel.AddingNewEventHandler 

Public Custom Event AddingNew As AddingNewEventHandler 

Typ zdarzenia

AddingNewEventHandler

Wyjątki

InvalidOperationException

NewObject nie jest tym samym typem, co typ zawarty na liście.

Przykłady

Poniższy przykład kodu używa BindingSource składnika do powiązania listy z kontrolką DataGridView . Nowe elementy są dodawane do listy przez program obsługi zdarzeń AddingNew . Ten przykładowy kod jest częścią większego przykładu przedstawionego w temacie How to: Customize Item Addition with the Windows Forms BindingSource (Jak dostosować dodawanie elementu za pomocą 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

Uwagi

Zdarzenie AddingNew występuje przed dodaniu nowego obiektu do bazowej listy reprezentowanej List przez właściwość . To zdarzenie jest wyzwalane po wywołaniu AddNew metody , ale przed utworzeniem nowego elementu i dodaniu go do bazowej listy. Dzięki obsłudze tego zdarzenia programista może zapewnić niestandardowe działanie tworzenia i wstawiania elementów bez konieczności wyprowadzania z BindingSource klasy. Jest to realizowane w procedurze obsługi zdarzeń przez ustawienie NewObject właściwości parametru System.ComponentModel.AddingNewEventArgs na nowy element. Nowy obiekt utworzony w AddingNew zdarzeniu musi być tego samego typu co typ zawarty na liście lub wystąpi wyjątek. Nie można ustawić NewObject właściwości w przypadku powiązania z elementem DataView lub DataTable , ponieważ nie można dodać nowego DataRowView elementu do listy.

Aby uzyskać więcej informacji na temat dostarczania niestandardowych funkcji nowego elementu, zobacz metodę AddNew . Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.

Zobacz też

• AddNew()
• OnAddingNew(AddingNewEventArgs)
• AddingNewEventArgs