FormView.OnBubbleEvent(Object, EventArgs) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Обрабатывает событие, передаваемое через иерархию элементов управления.
protected:
override bool OnBubbleEvent(System::Object ^ source, EventArgs ^ e);protected override bool OnBubbleEvent(object source, EventArgs e);override this.OnBubbleEvent : obj * EventArgs -> boolProtected Overrides Function OnBubbleEvent (source As Object, e As EventArgs) As BooleanПараметры
- source
- Object
Источник события.
Возвращаемое значение
true Чтобы указать, что событие должно быть передано дальше по иерархии элементов управления; falseв противном случае .
Комментарии
Метод Control.OnBubbleEvent используется элементом управления для обработки событий, передаваемых через иерархию RaiseBubbleEvent элементов управления методом. Он определяет, следует ли обрабатывать событие, проверяя свойства EventArgs объекта, содержащегося в параметре e . При обработке события метод выполняет соответствующее действие. Другие события игнорируются и передаются в иерархию элементов управления. Этот метод указывает, следует ли передавать событие дальше иерархии элементов управления через возвращаемое значение.
Элемент FormView управления переопределяет базовую реализацию этого метода, чтобы выполнить соответствующее действие при щелчке одной из кнопок, распознанных элементом управления. В следующей таблице перечислены кнопки команд, распознаемые элементом FormView управления.
| Кнопка | Значение CommandName | Описание |
|---|---|---|
| Отменить | "Отмена" | Используется при обновлении или вставке операций для отмены операции и удаления значений, введенных пользователем. Затем FormView элемент управления возвращается в режим, указанный свойством DefaultMode . |
| Удалить | "Удалить" | Используется при удалении операций удаления отображаемой записи из источника данных. ItemDeleting Вызывает и ItemDeleted события. |
| Изменить | "Изменить" | Используется в операциях обновления, чтобы поместить FormView элемент управления в режим редактирования. Содержимое, указанное в свойстве EditItemTemplate , отображается для строки данных. |
| Вставить | "Вставка" | Используется при вставке операций, чтобы попытаться вставить новую запись в источник данных со значениями, предоставленными пользователем. ItemInserting Вызывает и ItemInserted события. |
| Новое | "Создать" | Используется при вставке операций, чтобы поместить FormView элемент управления в режим вставки. Содержимое, указанное в свойстве InsertItemTemplate , отображается для строки данных. |
| Стр. | Страница | Используется в операциях разбиения на страницы для представления кнопки в строке пейджера, которая выполняет разбиение по страницам. Чтобы указать операцию разбиения на страницы, задайте CommandArgument для свойства кнопки значение Next, Prev, First, Last или индекс страницы, на которую нужно перейти.
PageIndexChanging Вызывает и PageIndexChanged события.
Примечание: Этот тип кнопки обычно используется только в шаблоне пейджера. |
| Обновление | "Обновить" | Используется в операциях обновления, чтобы попытаться обновить отображаемую запись в источнике данных со значениями, предоставленными пользователем. ItemUpdating Вызывает и ItemUpdated события. |
Эта версия метода возвращается true при обработке одной из этих кнопок. Дополнительные сведения о бурных событиях см. в разделе "Обработка и создание событий".
Примечания для тех, кто наследует этот метод
При расширении FormView класса можно переопределить этот метод для обработки собственных событий. Обязательно используйте возвращаемое значение, чтобы указать, следует ли передавать событие дальше по иерархии элементов управления.
