AddingNewEventArgs Класс

Определение

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

System.ComponentModel

Сборки:

netstandard.dll, System.ComponentModel.TypeConverter.dll

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

AddingNewEventArgs.cs

Предоставляет данные о событии AddingNew.

public ref class AddingNewEventArgs : EventArgs

public class AddingNewEventArgs : EventArgs

type AddingNewEventArgs = class
    inherit EventArgs

Public Class AddingNewEventArgs
Inherits EventArgs

Наследование

Object

EventArgs

AddingNewEventArgs

Примеры

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

Комментарии

Класс AddingNewEventArgs предоставляет данные для BindingSource.AddingNew события, который сигнализирует о том, что элемент будет добавлен в коллекцию. Событие дает программисту в обработчике AddingNewEventHandlerсобытий возможность предоставления нового объекта путем задания NewObject свойства этому новому элементу. Если это свойство не задано, коллекция обычно будет использовать конструктор без параметров соответствующего типа для создания нового элемента. В любом случае новый элемент будет добавлен в коллекцию.

Если коллекция также реализует ICancelAddNew интерфейс, элемент будет предварительно добавлен, ожидая последующей фиксации или отката.

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

Дополнительные сведения об обработке событий см. в разделе "Обработка и создание событий".

Конструкторы

Имя	Описание
AddingNewEventArgs()	Инициализирует новый экземпляр AddingNewEventArgs класса без параметров.
AddingNewEventArgs(Object)	Инициализирует новый экземпляр AddingNewEventArgs класса, используя указанный объект в качестве нового элемента.

Свойства

Имя	Описание
NewObject	Возвращает или задает объект, добавляемый в список привязок.

Методы

Имя	Описание
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

• AddingNewEventHandler
• AddingNew
• ICancelAddNew