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 . |
| DELETE | "Удалить" | Используется в операциях удаления отображаемой записи из источника данных. Вызывает ItemDeleting события и ItemDeleted . |
| Изменить | "Изменить" | Используется в операциях обновления для вывода FormView элемента управления в режим редактирования. Содержимое, указанное в свойстве EditItemTemplate , отображается для строки данных. |
| Атрибут Insert | "Вставка" | Используется в операциях вставки для попытки вставки новой записи в источник данных со значениями, предоставленными пользователем. Вызывает ItemInserting события и ItemInserted . |
| Создать | "Создать" | Используется в операциях вставки для вывода FormView элемента управления в режим вставки. Содержимое, указанное в свойстве InsertItemTemplate , отображается для строки данных. |
| Страница | "Страница" | Используется в операциях разбиения на страницы для представления кнопки в строке пейджера, которая выполняет разбиение по страницам. Чтобы указать операцию разбиения по страницам, присвойте CommandArgument свойству кнопки значение "Далее", "Prev", "First", "Last" или индекс страницы, на которую нужно перейти. Вызывает PageIndexChanging события и PageIndexChanged .
Примечание: Этот тип кнопки обычно используется только в шаблоне пейджера. |
| Update | "Обновить" | Используется в операциях обновления, чтобы попытаться обновить отображаемую запись в источнике данных значениями, предоставленными пользователем. Вызывает ItemUpdating события и ItemUpdated . |
Эта версия метода возвращает значение true при обработке одной из этих кнопок. Дополнительные сведения о восходящем просмотре событий см. в разделе Обработка и вызов событий.
Примечания для тех, кто наследует этот метод
При расширении FormView класса можно переопределить этот метод для обработки собственных событий. Обязательно используйте возвращаемое значение, чтобы указать, следует ли передавать событие дальше вверх по иерархии элементов управления.
