Partilhar via


FormView.OnBubbleEvent(Object, EventArgs) Método

Definição

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 -> bool
Protected Overrides Function OnBubbleEvent (source As Object, e As EventArgs) As Boolean

Parâmetros

source
Object

A fonte do evento.

e
EventArgs

Um EventArgs que contém os dados 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.

Aplica-se a

Confira também