BindingSource.AddingNew Событие

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

BindingSource.cs

Происходит перед добавлением элемента в базовый список.

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

public event System.ComponentModel.AddingNewEventHandler? AddingNew;

member this.AddingNew : System.ComponentModel.AddingNewEventHandler 

Public Custom Event AddingNew As AddingNewEventHandler 

Тип события

AddingNewEventHandler

Исключения

InvalidOperationException

NewObject не совпадает с типом, содержащимся в списке.

Примеры

В следующем примере кода компонент используется BindingSource для привязки списка к элементу DataGridView управления. Новые элементы добавляются в список обработчиком AddingNew событий. Этот пример кода является частью более крупного примера, приведенного в разделе "Практическое руководство. Настройка добавления элементов с помощью Привязки Windows Forms".

// 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 . Это событие запускается после AddNew вызова метода, но до создания и добавления нового элемента в базовый список. Обрабатывая это событие, программист может обеспечить поведение создания и вставки пользовательских элементов без принудительного BindingSource получения от класса. Это достигается в обработчике событий, задав NewObject свойство System.ComponentModel.AddingNewEventArgs параметра новому элементу. Новый объект, созданный в AddingNew событии, должен иметь тот же тип, что и тип, содержащийся в списке, или исключение. Невозможно задать NewObject свойство при привязке к списку DataView или DataTable из-за невозможности добавления нового DataRowView в список.

Дополнительные сведения о предоставлении пользовательских функций нового элемента см. в этом методе AddNew . Дополнительные сведения об обработке событий см. в разделе "Обработка и создание событий".

См. также раздел

• AddNew()
• OnAddingNew(AddingNewEventArgs)
• AddingNewEventArgs