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

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

Элемент, который нужно добавить в список.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).

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