AddingNewEventHandler Делегат

Определение

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

System.ComponentModel

Сборка:

System.ComponentModel.TypeConverter.dll

Представляет метод обработки события 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 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

Комментарии

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

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

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

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

GetMethodInfo(Delegate)

Получает объект, представляющий метод, представленный указанным делегатом.

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

• AddingNewEventArgs
• BindingSource
• BindingList<T>