FormView.OnBubbleEvent(Object, EventArgs) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Manipula um evento passado para cima por meio da hierarquia de controle.
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
A fonte do evento.
Retornos
true para indicar que o evento deve ser passado mais para cima na hierarquia de controle; caso contrário, false.
Comentários
O Control.OnBubbleEvent método é usado pelo controle para manipular opcionalmente eventos passados por meio da hierarquia de controle pelo RaiseBubbleEvent método . Ele determina se um evento deve ser manipulado examinando as propriedades do EventArgs objeto contido no e parâmetro . Quando um evento precisa ser tratado, o método executa a ação apropriada. Outros eventos são ignorados e passados para cima da hierarquia de controle. Esse método indica se o evento deve passar o evento mais acima da hierarquia de controle por meio de seu valor retornado.
O FormView controle substitui a implementação base desse método para executar a ação apropriada quando um dos botões reconhecidos pelo controle é clicado. A tabela a seguir lista os botões de comando que o FormView controle reconhece.
| Botão | Valor CommandName | Descrição |
|---|---|---|
| Cancelar | "Cancelar" | Usado na atualização ou inserção de operações para cancelar a operação e descartar os valores inseridos pelo usuário. Em FormView seguida, o controle retorna ao modo especificado pela DefaultMode propriedade . |
| Excluir | "Excluir" | Usado na exclusão de operações para excluir o registro exibido da fonte de dados. Gera os ItemDeleting eventos e ItemDeleted . |
| Editar | "Editar" | Usado na atualização de operações para colocar o FormView controle no modo de edição. O conteúdo especificado na EditItemTemplate propriedade é exibido para a linha de dados. |
| Inserir | "Inserir" | Usado na inserção de operações para tentar inserir um novo registro na fonte de dados com os valores fornecidos pelo usuário. Gera os ItemInserting eventos e ItemInserted . |
| Novo | "Novo" | Usado na inserção de operações para colocar o FormView controle no modo de inserção. O conteúdo especificado na InsertItemTemplate propriedade é exibido para a linha de dados. |
| Página | "Página" | Usado em operações de paginação para representar um botão na linha do pager que executa paginação. Para especificar a operação de paginação, defina a CommandArgument propriedade do botão como "Avançar", "Prev", "Primeiro", "Último" ou o índice da página para a qual navegar. Gera os PageIndexChanging eventos e PageIndexChanged .
Nota: Esse tipo de botão normalmente é usado apenas no modelo de pager. |
| Atualizar | "Atualizar" | Usado na atualização de operações para tentar atualizar o registro exibido na fonte de dados com os valores fornecidos pelo usuário. Gera os ItemUpdating eventos e ItemUpdated . |
Esta versão do método retorna true quando um desses botões é tratado. Para obter mais informações sobre o borbulhamento de eventos, consulte Manipulando e levantando eventos.
Notas aos Herdeiros
Ao estender a FormView classe, você pode substituir esse método para lidar com seus próprios eventos. Use o valor retornado para indicar se o evento deve ser passado mais para cima na hierarquia de controle.
