BindingSource.AddingNew Zdarzenie

Definicja

Występuje, zanim element zostanie dodany do listy podstawowej.Occurs before an item is added to the underlying list.

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

NewObject nie jest tym samym typem, który znajduje się na liście.NewObject is not the same type as the type contained in the list.

Przykłady

Poniższy przykład kodu używa składnika, BindingSource Aby powiązać listę z DataGridView kontrolką.The following code example uses a BindingSource component to bind a list to a DataGridView control. Nowe elementy są dodawane do listy przez AddingNew program obsługi zdarzeń.New items are added to the list by the AddingNew event handler. Ten przykład kodu jest częścią większego przykładu przedstawionego w temacie How to: Dostosowywanie dodawania elementów za pomocą źródła danych Windows Forms.This code example is part of a larger example provided in How to: Customize Item Addition with the 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

AddingNewZdarzenie występuje przed dodaniem nowego obiektu do podstawowej listy reprezentowanej przez List Właściwość.The AddingNew event occurs before a new object is added to the underlying list represented by the List property. To zdarzenie jest wywoływane po AddNew wywołaniu metody, ale przed utworzeniem nowego elementu i dodaniem go do listy podstawowej.This event is fired after the AddNew method is called, but before the new item is created and added to the underlying list. Dzięki obsłudze tego zdarzenia programista może zapewnić niestandardowe zachowanie tworzenia i wstawiania elementów bez wymuszania wykluczania z BindingSource klasy.By handling this event, the programmer can provide custom item creation and insertion behavior without being forced to derive from the BindingSource class. Jest to realizowane w programie obsługi zdarzeń przez ustawienie NewObject właściwości System.ComponentModel.AddingNewEventArgs parametru na nowy element.This is accomplished in the event handler by setting the NewObject property of the System.ComponentModel.AddingNewEventArgs parameter to the new item. Nowy obiekt utworzony w AddingNew zdarzeniu musi być tego samego typu co typ zawarty na liście lub wystąpił wyjątek.The new object created in the AddingNew event must be of the same type as the type contained in the list or an exception will occur. Nie można ustawić NewObject właściwości w przypadku powiązania z DataView lub DataTable , ponieważ nie można dodać nowego elementu DataRowView do listy.You cannot set the NewObject property when bound to a DataView or DataTable because you cannot add a new DataRowView to the list.

Aby uzyskać więcej informacji na temat dostarczania funkcji niestandardowego nowego elementu, zobacz AddNew metodę.For more information about supplying custom new item functionality, see the AddNew method. Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa iwywoływanie zdarzeń.For more information about handling events, see Handling and Raising Events.

Dotyczy

Zobacz też