IBindingList.AddNew Метод

Определение

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

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

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

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

Исключения

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

Комментарии

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

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

Примечание

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

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

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