IBindingList.AddNew Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет новый элемент в список.
public:
System::Object ^ AddNew();public object? AddNew();public object AddNew();abstract member AddNew : unit -> objPublic Function AddNew () As ObjectВозвращаемое значение
Элемент, добавленный в список.
Исключения
AllowNew равно false.
Комментарии
Этот метод поддерживается только в том случае, если AllowNew имеет trueзначение; NotSupportedException в противном случае создается исключение.
Реализация этого метода означает, что IBindingList список должен понимать тип объектов, добавляемых в список, и должен понять, как создать новый экземпляр этого типа. Например, если у вас есть коллекция myCustomer объектов, AddNew метод должен добавить новый myCustomer объект в список.
Note
Если объекты в этом списке реализуют IEditableObject интерфейс, вызов CancelEdit метода должен отменить объект, а не добавить его в список, когда объект был создан с помощью AddNew метода. Объект должен быть добавлен только в список при вызове IEditableObject.EndEdit метода. Поэтому необходимо тщательно синхронизировать объект и список.
При вызове этого метода необходимо вызвать ListChanged событие с ItemAdded перечислением, на который будет содержаться соответствующий индекс. Добавленная строка находится в состоянии, где нажатие клавиши ESC на DataGridView элемент управления может удалить новую строку. ListChanged Вызов события с ItemAdded перечислением во второй раз в этой строке указывает, что элемент теперь является обычной строкой (не в новом состоянии).
