Visão Geral dos Controles do Servidor Web de Botão

Artigo
10/15/2014

Use o os controles de servidor Web ASP.NET de botão para permitir que os usuários postem uma página para o servidor e um disparem um evento em uma página.

Esse tópico contém:

Segundo plano
Exemplos de código
Referência de Classe

Segundo plano

Você pode usar a controle de servidor Web Button para fornecer aos usuários a capacidade de enviar uma página para o servidor.O controle aciona um evento no código do servidor que você pode manipular para responder à postagem.Por exemplo, um usuário pode indicar que eles concluíram um formulário ou que desejam executar um comando específico.

O ASP.NET inclui três tipos de controles de botão, cada um deles aparece de forma diferente em páginas da Web, como listados na tabela a seguir:

Controle	Descrição
Button	Apresenta um botão de comando padrão, que é processado como um elemento input HTML.
LinkButton	Processado como um hiperlink na página.Entretanto, ele contém script do lado do cliente que faz com que o formulário seja postado de volta (posted back) para o servidor.(Você pode criar um hiperlink verdadeiro usando o controle de servidor Web HyperLink.)
ImageButton	Processa um elemento gráfico como um botão.Isso é útil para apresentar uma aparência rica do botão.O controle ImageButton também fornece informações sobre as coordenadas no gráfico onde foi clicado.

Você também pode usar os controles HtmlButton e HtmlInputButton para criar botões na página que são programáveis no código do servidor.Para obter detalhes sobre as diferenças entre HTMA e controles de servidor Web, consulte Visão geral sobre controles do servidor da Web do ASP.NET.

O controle ImageMap permite que você crie um elemento gráfico que tenha pontos de acesso que os usuários podem clicar para executar um postback ou outra ação.

Eventos de Botão

Quando um usuário clicar em qualquer botão de controle de servidor Web, a página é enviada para o servidor.Isso faz com que a página da Web seja processada e que quaisquer eventos pendentes sejam disparados no código com base no servidor.Os botões também podem levantar seus próprios eventos Click, para o qual você pode gravar manipuladores de eventos.

Validação e Controles de Botão

Se uma página contiver controles do validator ASP.NET, por padrão, o clique em um controle de botão fará com que o controle do validador execute sua verificação.Se a validação do lado do cliente estiver ativada para um controle do validador, a página não é enviada se verificação de uma validação falhar.

A tabela a seguir descreve as propriedades suportadas por controles de botão que permitem que você controle o processo de validação com mais precisão.

Propriedade	Descrição
CausesValidation	Especifica se clicando no botão também executará uma verificação de validação.Defina essa propriedade como false para impedir uma verificação de validação.
ValidationGroup	Permite que você especifique quais validadores na página serão chamados quando o botão for clicado.Se nenhum grupo de validação for estabelecido, um clique de botão chamará todos os validadores que estiverem na página.

Para obter mais informações, consulte Validando Entrada de Usuário em Páginas da Web ASP.NET.

Comportamento de PostBack do Botão

Quando os usuários em um controle de botão, a página é enviada de volta para o servidor.Por padrão, a página é enviada de volta para ela mesma, onde a mesma página é gerada novamente e os manipuladores de eventos para os controles na página são processados.

Você pode configurar os botões para postar a página atual para outra página.Isso pode ser útil para criar formulários de várias páginas.Para obter detalhes, consulte:Postagem entre Páginas em Páginas da Web do ASP.NET.

Por padrão, o controle Button envia a página usando uma operação de postagem HTML.Os controles LinkButton e ImageButton não podem oferecer suporte diretamente uma operação HTML POST.Portanto, quando você usa esses botões, eles adicionam script de cliente para a página que permitem que os controles enviem a página programaticamente.(Os controles LinkButton e ImageButton, portanto, exigem que script de cliente esteja ativado no navegador.)

Em algumas circunstâncias, você pode desejar que o controle Button também use script de cliente para executar a postagem.Isso pode ser útil se você desejar manipular o postback programaticamente, assim como anexá-lo a outros elementos na página.Você pode definir a propriedade UseSubmitBehavior do controle Button como true para fazer com que o controle Button use postback de scripts baseados em cliente.

Usando botões com controles UpdatePanel

renderização parcial da página torna possível atualizar partes de uma página sem um postback.UpdatePanel controles permitem marcar partes da página participam do renderização parcial da página. Por padrão, o comportamento dos controles dentro de um controle UpdatePanel, incluindo controles Button, é realizar um postback assíncrono em vez de um postback.Isso atualiza somente o conteúdo do controle UpdatePanel do qual se origina a postagem.

Em adição ao cenário de um controle Button que está dentro de um controle UpdatePanel, você pode usar controles Button com controlesUpdatePanel nas seguintes situações:

Definir um controle Button que esteja fora de um controle UpdatePanel como um controle AsyncPostBackTriggerpara esse painel.Quando o botão é clicado, ele executa um postback assíncrono e atualiza o conteúdo do painel.
Definir um controle Button que esteja dentro de um controle UpdatePanel como um PostBackTriggerpara o painel.Quando o botão é clicado, ele executa uma postagem mesmo que ela esteja dentro de um controle UpdatePanel.

Para obter mais informações sobre processamento página-parcial e como usar controles UpdatePanel, consulte Visão geral sobre controle UpdatePanel e Visão geral de renderização de página parcial.

Manipulando Eventos do Lado do Cliente para Controles de Botão

Controles de botão podem disparar tanto eventos de servidor quanto eventos de cliente.Eventos de servidor ocorrem depois do postback, e eles são manipulados no código do lado do servidor que você escrever para a página.Eventos de cliente são tratados no script de cliente, normalmente ECMAScript (JavaScript), e são disparados antes da a página ser enviada.Adicionando eventos do lado do cliente aos controles de botão do ASP.NET, você pode executar tarefas, tais como exibir caixas de diálogo de confirmação antes de enviar a página, e possivelmente cancelar o envio.Para obter detalhes, consulte Script de Cliente em Páginas da Web ASP.NET e Como: Responder a botão controle de servidor Web Events in cliente Script.

Botões em Controles de Dados

Controles de servidor Web de botões são usados com frequência em controles de dados, como nos controles de lista DataList, GridView e Repeater.Nesses casos, você normalmente não responde diretamente para o evento de clique de botão.Em vez disso, um botão em um controle de dados gera um evento que seja específico para o controle de dados.Por exemplo, no controle DataList, um botão pode levantar o evento ItemCommand do controle DataList em vez de levantar o evento Click do controle Button.

Como controles de lista ligados a dados podem conter muitos botões, você pode definir a propriedade CommandArgument do botão para especificar um valor para passar como parte do evento.Você pode então testar este argumento para ver qual botão foi clicado.

Ligando Dados aos Controles

Você pode ligar os controles do servidor Web de botão a uma fonte de dados, para controlar suas configurações de propriedade dinamicamente.Por exemplo, você pode define um botão da propriedade Text usando associação de dados.