AddingNewEventHandler Делегат

Определение

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

System.ComponentModel

Сборки:

netstandard.dll, System.ComponentModel.TypeConverter.dll

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

AddingNewEventHandler.cs

Представляет метод, который будет обрабатывать AddingNew событие.

public delegate void AddingNewEventHandler(System::Object ^ sender, AddingNewEventArgs ^ e);

public delegate void AddingNewEventHandler(object? sender, AddingNewEventArgs e);

type AddingNewEventHandler = delegate of obj * AddingNewEventArgs -> unit

Public Delegate Sub AddingNewEventHandler(sender As Object, e As AddingNewEventArgs)

Параметры

sender

Object

Источник события, как правило, контейнер данных или коллекция с привязкой к данным.

e

AddingNewEventArgs

Объект, AddingNewEventArgs содержащий данные события.

Примеры

В следующем примере кода показано, как использовать AddingNewEventHandler делегат для обработки BindingSource.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

Комментарии

Событие BindingSource.AddingNew происходит до добавления нового элемента в коллекцию, как правило, в сценариях привязки данных. Обработчик этого события может предоставить добавленный новый элемент, переопределив стандартное действие класса коллекции. Это достигается путем задания NewObject свойства AddingNewEventArgs параметра e этому новому элементу. Обычно этот элемент должен иметь тип, ожидаемый коллекцией получателей, или коллекция создает исключение типа InvalidCastException.

Это событие обычно используется в сценариях привязки данных в таких классах, как System.Windows.Forms.BindingSource и System.ComponentModel.BindingList<T>.

При создании делегата AddingNewEventHandler вы определите метод, который будет обрабатывать событие. Чтобы связать событие с обработчиком событий, добавьте экземпляр делегата в событие. Обработчик событий вызывается всякий раз, когда происходит событие, если вы не удалите делегат. Дополнительные сведения о делегатах обработчика событий см. в разделе "Обработка и создание событий".

Методы расширения

Имя	Описание
GetMethodInfo(Delegate)	Возвращает объект, представляющий метод, представленный указанным делегатом.

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

• AddingNewEventArgs
• BindingSource
• BindingList<T>