IBindingList.AddNew Метод

Определение

Добавляет новый элемент в список.

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

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

Object

Элемент, который нужно добавить в список.

Исключения

AllowNew имеет значение false.

Комментарии

Этот метод поддерживается только в AllowNew том случае, если имеет значение true ; в противном случае NotSupportedException создается исключение.

Реализация этого метода означает, что IBindingList список должен понимать тип объектов, добавляемых в список, и должен понимать, как создать новый экземпляр этого типа. Например, если имеется коллекция myCustomer объектов, AddNew метод должен добавить myCustomer в список новый объект.

Примечание

Если объекты в этом списке реализуют IEditableObject интерфейс, вызов CancelEdit метода должен отбросить объект, а не добавлять его в список, когда объект был создан с помощью AddNew метода. Объект должен быть добавлен в список только при IEditableObject.EndEdit вызове метода. Поэтому необходимо тщательно синхронизировать объект и список.

При вызове этого метода необходимо вызвать ListChanged событие с ItemAdded перечислением, содержащим соответствующий индекс. Добавленная строка находится в состоянии, в котором нажатие клавиши ESC на DataGridView элементе управления может удалить новую строку. Вызов ListChanged события с ItemAdded перечислением второй раз в этой строке означает, что элемент теперь является обычной строкой (не в новом состоянии).

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