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 в этой строке означает, что элемент теперь является обычной строкой (не в новом состоянии).