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 pela 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 ainda 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 pela 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 ser transmitido ainda mais para cima na 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 |
|---|---|---|
| Cancel | "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 o ItemDeleting e ItemDeleted eventos. |
| 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 o ItemInserting e ItemInserted eventos. |
| 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 a paginação. Para especificar a operação de paginação, defina a CommandArgument propriedade do botão como "Next", "Prev", "First", "Last" ou o índice da página para a qual navegar. Gera o PageIndexChanging e PageIndexChanged eventos.
Nota: Esse tipo de botão normalmente é usado apenas no modelo de pager. |
| Atualização | "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 o ItemUpdating e ItemUpdated eventos. |
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 ainda mais para cima na hierarquia de controle.
