BindingSource.AddingNew BindingSource.AddingNew BindingSource.AddingNew BindingSource.AddingNew Event

Определение

Происходит перед добавлением элемента в базовый список.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 

Исключения

Тип свойства NewObject не совпадает с типом, содержащимся в списке.NewObject is not the same type as the type contained in the list.

Примеры

В следующем примере кода используется BindingSource компонент для привязки списка DataGridView к элементу управления.The following code example uses a BindingSource component to bind a list to a DataGridView control. Новые элементы добавляются в список AddingNew обработчиком событий.New items are added to the list by the AddingNew event handler. Этот пример кода является частью более крупного примера, приведенного в разделе как: Настройка добавления элементов с помощью BindingSourceWindows 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

Комментарии

Это AddingNew событие возникает перед добавлением нового объекта в базовый список, представленный List свойством.The AddingNew event occurs before a new object is added to the underlying list represented by the List property. Это событие возникает после AddNew вызова метода, но перед созданием нового элемента и его добавлением в базовый список.This event is fired after the AddNew method is called, but before the new item is created and added to the underlying list. Обрабатывая это событие, программист может предоставить возможность создания и вставки пользовательских элементов без необходимости наследовать от BindingSource класса.By handling this event, the programmer can provide custom item creation and insertion behavior without being forced to derive from the BindingSource class. Это достигается в обработчике событий путем присвоения NewObject свойству System.ComponentModel.AddingNewEventArgs параметра нового элемента.This is accomplished in the event handler by setting the NewObject property of the System.ComponentModel.AddingNewEventArgs parameter to the new item. Новый объект, созданный в AddingNew событии, должен иметь тот же тип, что и тип, содержащийся в списке, или возникнет исключение.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. Невозможно задать NewObject свойство при привязке DataView к или DataTable , поскольку нельзя добавить новый DataRowView объект в список.You cannot set the NewObject property when bound to a DataView or DataTable because you cannot add a new DataRowView to the list.

Дополнительные сведения о предоставлении пользовательских функций нового элемента см. в AddNew описании метода.For more information about supplying custom new item functionality, see the AddNew method. Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about handling events, see Handling and Raising Events.

Применяется к

Дополнительно