IBindingList.AddNew Метод

Определение

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

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

Возвращаемое значение

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. Добавленная строка находится в состоянии, в котором нажатие клавиши ESC на DataGridView элементе управления может удалить новую строку.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).

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