FormView.OnBubbleEvent(Object, EventArgs) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Controla un evento elevado en la jerarquía de controles.
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 BooleanParámetros
- source
- Object
Origen del evento.
Devoluciones
Es true para indicar que el evento se debe pasar más arriba en la jerarquía de controles; de lo contrario, es false.
Comentarios
El Control.OnBubbleEvent control usa el método para controlar opcionalmente los eventos pasados a través de la jerarquía de controles por el RaiseBubbleEvent método . Determina si se debe controlar un evento examinando las propiedades del EventArgs objeto contenido en el e parámetro . Cuando es necesario controlar un evento, el método realiza la acción adecuada. Otros eventos se omiten y pasan la jerarquía de controles. Este método indica si se debe pasar el evento más allá de la jerarquía de controles a través de su valor devuelto.
El FormView control invalida la implementación base de este método para realizar la acción adecuada cuando se hace clic en uno de los botones reconocidos por el control. En la tabla siguiente se enumeran los botones de comando que reconoce el FormView control.
| Botón | Valor commandName | Descripción |
|---|---|---|
| Cancelar | "Cancelar" | Se usa en la actualización o inserción de operaciones para cancelar la operación y descartar los valores especificados por el usuario. A FormView continuación, el control vuelve al modo especificado por la DefaultMode propiedad . |
| Eliminar | “Eliminar” | Se usa en la eliminación de operaciones para eliminar el registro mostrado del origen de datos. Genera los ItemDeleting eventos y ItemDeleted . |
| Editar | "Editar" | Se usa en las operaciones de actualización para colocar el FormView control en modo de edición. El contenido especificado en la EditItemTemplate propiedad se muestra para la fila de datos. |
| Insertar | "Insertar" | Se usa en las operaciones de inserción para intentar insertar un nuevo registro en el origen de datos con los valores proporcionados por el usuario. Genera los ItemInserting eventos y ItemInserted . |
| Nuevo | "Nuevo" | Se usa en las operaciones de inserción para colocar el FormView control en modo de inserción. El contenido especificado en la InsertItemTemplate propiedad se muestra para la fila de datos. |
| Página | "Página" | Se usa en las operaciones de paginación para representar un botón en la fila del buscapersonas que realiza la paginación. Para especificar la operación de paginación, establezca la CommandArgument propiedad del botón en "Next", "Prev", "First", "Last" o el índice de la página en la que se va a navegar. Genera los PageIndexChanging eventos y PageIndexChanged .
Nota: Este tipo de botón se usa normalmente solo en la plantilla de buscapersonas. |
| Actualizar | "Actualizar" | Se usa en las operaciones de actualización para intentar actualizar el registro mostrado en el origen de datos con los valores proporcionados por el usuario. Genera los ItemUpdating eventos y ItemUpdated . |
Esta versión del método devuelve true cuando se controla uno de estos botones. Para obtener más información sobre la propagación de eventos, consulte Control y generación de eventos.
Notas a los desarrolladores de herederos
Al extender la FormView clase, puede invalidar este método para controlar sus propios eventos. Asegúrese de usar el valor devuelto para indicar si el evento debe pasarse más allá de la jerarquía de controles.
