IBindingList.AddNew IBindingList.AddNew IBindingList.AddNew IBindingList.AddNew Method

Определение

Добавляет новый элемент в список.Adds a new item to the list.

public:
 System::Object ^ AddNew();
public object AddNew ();
abstract member AddNew : unit -> obj
Public Function AddNew () As Object

Возвраты

Элемент, который нужно добавить в список.The item added to the list.

Исключения

Свойство AllowNew имеет значение false.AllowNew is false.

Комментарии

Этот метод поддерживается только в том AllowNew случае true, NotSupportedException если имеет значение; в противном случае создается исключение.This method is supported only if AllowNew is true; otherwise, a NotSupportedException is thrown.

Реализация этого метода означает, что IBindingList список должен понимать тип объектов, добавляемых в список, и должен понимать, как создать новый экземпляр этого типа.Implementing this method means that the IBindingList list must understand the type of objects to add to the list and must understand how to create a new instance of that type. Например, если имеется коллекция myCustomer объектов AddNew , метод должен добавить в список новый myCustomer объект.For example, if you have a collection of myCustomer objects, the AddNew method should add a new myCustomer object to the list.

Примечание

Если объекты в этом списке реализуют IEditableObject интерфейс, CancelEdit вызов метода должен отбросить объект, а не добавлять его в список, когда AddNew объект был создан с помощью метода.If the objects in this list implement the IEditableObject interface, calling the CancelEdit method should discard an object, not add it to the list, when the object was created using the AddNew method. Объект должен быть добавлен в список только при IEditableObject.EndEdit вызове метода.The object should only be added to the list when the IEditableObject.EndEdit method is called. Поэтому необходимо тщательно синхронизировать объект и список.Therefore, you must synchronize the object and the list carefully.

При вызове этого метода необходимо вызвать ListChanged событие ItemAdded с перечислением, содержащим соответствующий индекс.When this method is called, you should raise a ListChanged event with the ItemAdded enumeration carrying the appropriate index. Добавленная строка находится в состоянии, в котором DataGridView нажатие клавиши ESC на элементе управления может удалить новую строку.The added row is in a state where hitting Esc on a DataGridView control can remove the new row. ListChanged Вызов события ItemAdded с перечислением второй раз в этой строке означает, что элемент теперь является обычной строкой (не в новом состоянии).Raising the ListChanged event with the ItemAdded enumeration a second time on this row indicates that the item is now a normal row (not in new state).

Применяется к