FormView.OnBubbleEvent(Object, EventArgs) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Trata um evento passado pela hierarquia de controlo.
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 origem do evento.
Devoluções
true para indicar que o evento deve ser passado mais acima na hierarquia de controlo; caso contrário, false.
Observações
O Control.OnBubbleEvent método é usado pelo controlo para, opcionalmente, gerir eventos passados pela hierarquia de controlo pelo RaiseBubbleEvent método. Determina se deve lidar com um evento examinando as propriedades do EventArgs objeto contido no e parâmetro. Quando um evento precisa de ser tratado, o método executa a ação apropriada. Outros eventos são ignorados e ultrapassados na hierarquia de controlo. Este método indica se deve passar o evento mais acima na hierarquia de controlo através do seu valor de retorno.
O FormView controlo sobrepõe-se à implementação base deste método para executar a ação apropriada quando um dos botões reconhecidos pelo controlo é pressionado. A tabela seguinte lista os botões de comando que o FormView controlo reconhece.
| Botão | Valor CommandName | Description |
|---|---|---|
| Cancelar | Cancelar | Usado na atualização ou inserção de operações para cancelar a operação e descartar os valores inseridos pelo utilizador. O FormView controlo regressa então ao modo especificado pela DefaultMode propriedade. |
| Delete | "Apagar" | Usado em operações de eliminação para eliminar o registo exibido da fonte de dados. Aumenta os ItemDeleting eventos e ItemDeleted eventos. |
| Editar | "Editar" | Usado na atualização de operações para colocar o FormView controlo em 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 registo na fonte de dados com os valores fornecidos pelo utilizador. Aumenta os ItemInserting eventos e ItemInserted eventos. |
| Novo | "Novo" | Usado em operações de inserção para colocar o FormView controlo em 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 realiza a paginação. Para especificar a operação de paginação, defina a CommandArgument propriedade do botão para "Próximo", "Anterior", "Primeiro", "Último" ou o índice da página para onde deve navegar. Aumenta os PageIndexChanging eventos e PageIndexChanged eventos.
Nota: Este tipo de botão é normalmente usado apenas no modelo do pager. |
| Atualizar | "Atualização" | Usado na atualização de operações para tentar atualizar o registo apresentado na fonte de dados com os valores fornecidos pelo utilizador. Aumenta os ItemUpdating eventos e ItemUpdated eventos. |
Esta versão do método retorna true quando um destes botões é manuseado. Para mais informações sobre o bubbling de eventos, consulte Manuseio e Criação de Eventos.
Notas para Herdeiros
Ao prolongar a FormView turma, pode ultrapassar este método para gerir os seus próprios eventos. Certifique-se de usar o valor de retorno para indicar se o evento deve ser passado mais acima na hierarquia de controlo.