BindingSource.AddingNew Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит перед добавлением элемента в базовый список.
public:
event System::ComponentModel::AddingNewEventHandler ^ AddingNew;
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 не совпадает с типом, содержащимся в списке.
Примеры
В следующем примере кода компонент используется BindingSource для привязки списка к элементу DataGridView управления . Новые элементы добавляются в список обработчиком AddingNew событий. Этот пример кода является частью более крупного примера, приведенного в разделе Практическое руководство. Настройка добавления элементов с помощью 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 . Это событие возникает после AddNew вызова метода , но до создания и добавления нового элемента в базовый список. Обрабатывая это событие, программист может обеспечить пользовательское поведение создания и вставки элементов без принудительного BindingSource наследование от класса . Для этого в обработчике событий задается NewObject новый элемент в свойстве System.ComponentModel.AddingNewEventArgs параметра . Новый объект, созданный в событии AddingNew , должен иметь тот же тип, что и тип, содержащийся в списке, иначе возникнет исключение. Невозможно задать свойство при привязке NewObjectDataView к или DataTable , так как нельзя добавить новый DataRowView объект в список.
Дополнительные сведения о предоставлении пользовательских функций нового элемента см. в методе AddNew . Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.