Button Classe

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.

Exibe um controle de botão de push na página da Web.

public ref class Button : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandler

public ref class Button : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::IButtonControl

public class Button : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandler

public class Button : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.IButtonControl

type Button = class
    inherit WebControl
    interface IPostBackEventHandler

type Button = class
    inherit WebControl
    interface IButtonControl
    interface IPostBackEventHandler

Public Class Button
Inherits WebControl
Implements IPostBackEventHandler

Public Class Button
Inherits WebControl
Implements IButtonControl, IPostBackEventHandler

Herança: Object

Control

WebControl
Button

Implementações: IPostBackEventHandler IButtonControl

Exemplos

O exemplo de código a seguir demonstra como criar um controle Enviar Button que posta o conteúdo da página da Web de volta para o servidor.

<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Button Example</title>
<script language="C#" runat="server">

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
         Message.Text="Hello World!!";
      }

   </script>
</head>
<body>
   <form id="form1" runat="server">

      <h3>Button Example</h3>

      Click on the submit button.<br /><br />
 
      <asp:Button id="Button1"
           Text="Submit"
           OnClick="SubmitBtn_Click" 
           runat="server"/>
       
      <br />

      <asp:label id="Message" runat="server"/>
 
   </form>
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Button Example</title>
<script language="VB" runat="server">
    Sub SubmitBtn_Click(sender As Object, e As EventArgs)
        Message.Text = "Hello World!!"
    End Sub 'SubmitBtn_Click
  </script>
</head>
<body>
   <form id="form1" runat="server">

      <h3>Button Example</h3>

      Click on the submit button.<br /><br />
 
      <asp:Button id="Button1"
           Text="Submit"
           OnClick="SubmitBtn_Click" 
           runat="server"/>
       
      <br />

      <asp:label id="Message" runat="server"/>
 
   </form>
</body>
</html>

O exemplo de código a seguir demonstra como criar um controle command Button que classifica uma lista.

<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Button CommandName Example</title>
<script runat="server">

      void CommandBtn_Click(Object sender, CommandEventArgs e) 
      {

         switch(e.CommandName)
         {

            case "Sort":

               // Call the method to sort the list.
               Sort_List((String)e.CommandArgument);
               break;

            case "Submit":

               // Display a message for the Submit button being clicked.
               Message.Text = "You clicked the Submit button";

               // Test whether the command argument is an empty string ("").
               if((String)e.CommandArgument == "")
               {
                  // End the message.
                  Message.Text += ".";
               }
               else
               {
                  // Display an error message for the command argument. 
                  Message.Text += ", however the command argument is not recogized.";
               }                
               break;

            default:

               // The command name is not recognized. Display an error message.
               Message.Text = "Command name not recogized.";
               break; 

         }

      }

      void Sort_List(string commandArgument)
      {

         switch(commandArgument)
         {

            case "Ascending":
 
               // Insert code to sort the list in ascending order here.
               Message.Text = "You clicked the Sort Ascending button.";
               break;

            case "Descending":
              
               // Insert code to sort the list in descending order here.
               Message.Text = "You clicked the Sort Descending button.";
               break;

            default:
        
               // The command argument is not recognized. Display an error message.
               Message.Text = "Command argument not recogized.";
               break;

         }

      }

   </script>

</head>
 
<body>

   <form id="form1" runat="server">

      <h3>Button CommandName Example</h3>

      Click on one of the command buttons.

      <br /><br />
 
      <asp:Button id="Button1"
           Text="Sort Ascending"
           CommandName="Sort"
           CommandArgument="Ascending"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

       

      <asp:Button id="Button2"
           Text="Sort Descending"
           CommandName="Sort"
           CommandArgument="Descending"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      <br /><br />

      <asp:Button id="Button3"
           Text="Submit"
           CommandName="Submit"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

       

      <asp:Button id="Button4"
           Text="Unknown Command Name"
           CommandName="UnknownName"
           CommandArgument="UnknownArgument"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

       

      <asp:Button id="Button5"
           Text="Submit Unknown Command Argument"
           CommandName="Submit"
           CommandArgument="UnknownArgument"
           OnCommand="CommandBtn_Click" 
           runat="server"/>
       
      <br /><br />

      <asp:Label id="Message" runat="server"/>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Button CommandName Example</title>
<script runat="server">

      Sub CommandBtn_Click(sender As Object, e As CommandEventArgs) 

         Select e.CommandName

            Case "Sort"

               ' Call the method to sort the list.
               Sort_List(CType(e.CommandArgument, String))

            Case "Submit"

               ' Display a message for the Submit button being clicked.
               Message.Text = "You clicked the Submit button"

               ' Test whether the command argument is an empty string ("").
               If CType(e.CommandArgument , String) = "" Then
              
                  ' End the message.
                  Message.Text &= "."
               
               Else
               
                  ' Display an error message for the command argument. 
                  Message.Text &= ", however the command argument is not recogized."
               
               End If                

            Case Else

               ' The command name is not recognized. Display an error message.
               Message.Text = "Command name not recogized."

         End Select

      End Sub

      Sub Sort_List(commandArgument As String)

         Select commandArgument

            Case "Ascending"
 
               ' Insert code to sort the list in ascending order here.
               Message.Text = "You clicked the Sort Ascending button."

            Case "Descending"
              
               ' Insert code to sort the list in descending order here.
               Message.Text = "You clicked the Sort Descending button."

            Case Else
        
               ' The command argument is not recognized. Display an error message.
               Message.Text = "Command argument not recogized."

         End Select

      End Sub

   </script>

</head>
 
<body>

   <form id="form1" runat="server">

      <h3>Button CommandName Example</h3>

      Click on one of the command buttons.

      <br /><br />
 
      <asp:Button id="Button1"
           Text="Sort Ascending"
           CommandName="Sort"
           CommandArgument="Ascending"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

       

      <asp:Button id="Button2"
           Text="Sort Descending"
           CommandName="Sort"
           CommandArgument="Descending"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

      <br /><br />

      <asp:Button id="Button3"
           Text="Submit"
           CommandName="Submit"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

       

      <asp:Button id="Button4"
           Text="Unknown Command Name"
           CommandName="UnknownName"
           CommandArgument="UnknownArgument"
           OnCommand="CommandBtn_Click" 
           runat="server"/>

       

      <asp:Button id="Button5"
           Text="Submit Unknown Command Argument"
           CommandName="Submit"
           CommandArgument="UnknownArgument"
           OnCommand="CommandBtn_Click" 
           runat="server"/>
       
      <br /><br />

      <asp:Label id="Message" runat="server"/>
 
   </form>
 
</body>
</html>

Comentários

Neste tópico:

Introdução
Eventos de servidor e comportamento de postback de botão
Manipulando eventos de botão no script do cliente
Controles de botão e validação
Botões em controles de dados
Associando dados aos controles
Usando botões com controles UpdatePanel
Sintaxe declarativa

Introdução

Use o Button controle para criar um botão de push na página da Web que permite que os usuários postem uma página no servidor. O controle dispara um evento no código do servidor que você pode manipular para responder ao postback. Ele também pode gerar um evento no script do cliente que você pode manipular antes que a página seja postada ou que possa ser executada e, em seguida, cancelar o envio da página.

Observação

ASP.NET inclui vários tipos de controles de botão, cada um deles aparece de forma diferente em páginas da Web. Eles são o Button controle, que é renderizado como um botão de push; o LinkButton controle, que é renderizado como um link; e o ImageButton controle, que é renderizado como uma imagem; e o ImageMap controle, que permite criar um gráfico com hotspots que os usuários podem clicar. Por padrão, todos os controles de botão enviam a página quando clicados. Você também pode usar o e HtmlInputButton os HtmlButton controles 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 controles HTML e servidor Web, consulte ASP.NET Visão geral dos controles do servidor Web.

Por padrão, um Button controle é um botão Enviar. Um botão Enviar não tem um nome de comando (especificado pela CommandName propriedade) associado ao botão e simplesmente posta a página da Web de volta no servidor. Você pode fornecer um manipulador de eventos para que o Click evento controle programaticamente as ações executadas quando o botão Enviar é clicado.

Um botão Comando tem um nome de comando associado ao botão, como Sort, por exemplo, definindo a CommandName propriedade. Isso permite que você crie vários Button controles em uma página da Web e determine programaticamente qual Button controle é clicado. Você também pode usar a CommandArgument propriedade com um botão de comando para fornecer informações adicionais sobre o comando a ser executado, como Ascending. Você pode fornecer um manipulador de eventos para que o Command evento controle programaticamente as ações executadas quando o botão Comando é clicado.

Eventos de servidor e comportamento de postback de botão

Quando um usuário clica em qualquer botão de controle do servidor Web, a página é enviada para o servidor. Isso faz com que a página da Web seja processada e todos os eventos pendentes sejam gerados no código baseado em servidor. Quando todo o processamento de página e controle for concluído, a página será renderizada no navegador novamente.

Os botões podem gerar seus próprios Click eventos ou Command eventos, que você pode manipular usando código baseado em servidor. Isso é diferente dos eventos em páginas HTML tradicionais ou em aplicativos Web baseados em cliente, em que o evento de onclick um botão é tratado usando JavaScript que é executado no cliente. Para obter mais informações, consulte ASP.NET modelo de evento de controle de servidor dos Web Forms.

Quando os usuários clicam em um controle de botão, a página é postada novamente no servidor. Por padrão, a página é postada de volta para si mesma,

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

Manipulando eventos de botão no script do cliente

Os controles de botão podem gerar eventos do servidor e eventos do cliente. Os eventos do servidor ocorrem após o postback e são tratados no código do lado do servidor que você escreve para a página. Os eventos do cliente são tratados no script do cliente, normalmente ECMAScript (JavaScript) e são gerados antes que a página seja enviada. Ao adicionar eventos do lado do cliente para ASP.NET controles de botão, você pode executar tarefas como exibir caixas de diálogo de confirmação antes de enviar a página e potencialmente cancelar o envio. Para obter detalhes, consulte o Script do Cliente em ASP.NET Páginas da Web e como responder a eventos de controle de servidor Web de botão no script do cliente.

Talvez você também queira que o Button controle use o script do cliente para executar o postback (em vez de simplesmente executar uma operação HTTP POST). Isso pode ser útil se você quiser manipular programaticamente o postback, como anexá-lo a outros elementos na página. Você pode definir a Button propriedade do UseSubmitBehavior controle para true fazer com que o controle use o Button post-back baseado em script do cliente.

Controles de botão e validação

Se uma página contiver controles de validador ASP.NET, por padrão, clicar 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 habilitada para um controle de validador, a página não será enviada se uma verificação de validação falhar.

A tabela a seguir descreve as propriedades compatíveis com controles de botão que permitem controlar o processo de validação com mais precisão.

Propriedade	Descrição
CausesValidation	Especifica se clicar no botão também executa uma verificação de validação. Defina essa propriedade para `false` impedir uma verificação de validação.
ValidationGroup	Permite especificar quais validadores na página são chamados quando o botão é clicado. Se nenhum grupo de validação for estabelecido, um clique no botão chamará todos os validadores que estão na página.

Para obter mais informações, consulte Validando a entrada do usuário em ASP.NET Páginas da Web.

Botões em controles de dados

Controles de servidor Web de botão geralmente são usados em controles de dados, como nos DataListcontroles , GridViewe Repeater lista. Nesses casos, normalmente você não responde diretamente ao evento de clique do botão. Em vez disso, um botão em um controle de dados gera um evento específico ao controle de dados. Por exemplo, no DataList controle, um botão pode aumentar o DataList evento do ItemCommand controle em vez de aumentar o Button evento do Click controle.

Como os controles de lista associados a dados podem conter muitos botões, você pode definir a propriedade do CommandArgument botão para especificar um valor a ser passado como parte do evento. Em seguida, você pode testar esse argumento para ver qual botão foi clicado.

Associando dados aos controles

Você pode associar 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 definir a propriedade de Text um botão usando a associação de dados.

Usando botões com controles UpdatePanel

A renderização de página parcial possibilita atualizar partes de uma página sem um postback. UpdatePanel os controles permitem marcar partes da página que participam da renderização de página parcial. Por padrão, o comportamento dos controles dentro de um UpdatePanel controle, incluindo Button controles, é executar um postback assíncrono em vez de um postback. Isso atualiza apenas o conteúdo do UpdatePanel controle do qual o postback se origina.

Além do cenário de um Button controle que está dentro de um UpdatePanel controle, você pode usar Button controles com UpdatePanel controles nos seguintes cenários:

Definindo um Button controle que está fora de um UpdatePanel controle como um AsyncPostBackTrigger controle para esse painel. Quando o botão é clicado, ele executa um postback assíncrono e atualiza o conteúdo do painel.
Definindo um Button controle que está dentro de um UpdatePanel controle como um PostBackTrigger para o painel. Quando o botão é clicado, ele executa um postback mesmo que esteja dentro de um UpdatePanel controle.

Para obter mais informações sobre a renderização de página parcial e o uso UpdatePanel de controles, consulte a Visão geral do controle UpdatePanel e Partial-Page Visão geral da renderização.

Sintaxe declarativa

<asp:Button
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CommandArgument="string"
    CommandName="string"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnClick="Click event handler"
    OnClientClick="string"
    OnCommand="Command event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PostBackUrl="uri"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    ToolTip="string"
    UseSubmitBehavior="True|False"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

Construtores

Nome	Description
Button()	Inicializa uma nova instância da classe Button.

Propriedades

Nome	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente até o controle do servidor Web. (Herdado de WebControl)
Adapter	Obtém o adaptador específico do navegador para o controle. (Herdado de Control)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle. (Herdado de Control)
Attributes	Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades no controle. (Herdado de WebControl)
BackColor	Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de WebControl)
BindingContainer	Obtém o controle que contém a associação de dados desse controle. (Herdado de Control)
BorderColor	Obtém ou define a cor da borda do controle Web. (Herdado de WebControl)
BorderStyle	Obtém ou define o estilo de borda do controle do servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da borda do controle do servidor Web. (Herdado de WebControl)
CausesValidation	Obtém ou define um valor que indica se a validação é executada quando o Button controle é clicado.
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle do servidor foram criados. (Herdado de Control)
ClientID	Obtém a ID de controle para marcação HTML gerada por ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo usado para gerar o valor da ClientID propriedade. (Herdado de Control)
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na ClientID propriedade. (Herdado de Control)
CommandArgument	Obtém ou define um parâmetro opcional passado para o Command evento junto com o associado CommandName.
CommandName	Obtém ou define o nome do comando associado ao Button controle que é passado para o Command evento.
Context	Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que representa os controles filho para um controle de servidor especificado na hierarquia da interface do usuário. (Herdado de Control)
ControlStyle	Obtém o estilo do controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
ControlStyleCreated	Obtém um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
CssClass	Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente. (Herdado de WebControl)
DataItemContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataKeysControl. (Herdado de Control)
DesignMode	Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control)
Enabled	Obtém ou define um valor que indica se o controle do servidor Web está habilitado. (Herdado de WebControl)
EnableTheming	Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de WebControl)
EnableViewState	Obtém ou define um valor que indica se o controle do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de representantes do manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control)
Font	Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de WebControl)
ForeColor	Obtém ou define a cor do primeiro plano (normalmente a cor do texto) do controle do servidor Web. (Herdado de WebControl)
HasAttributes	Obtém um valor que indica se o controle tem atributos definidos. (Herdado de WebControl)
HasChildViewState	Obtém um valor que indica se os controles filho do controle do servidor atual têm configurações de estado de exibição salvas. (Herdado de Control)
Height	Obtém ou define a altura do controle do servidor Web. (Herdado de WebControl)
ID	Obtém ou define o identificador programático atribuído ao controle do servidor. (Herdado de Control)
IdSeparator	Obtém o caractere usado para separar identificadores de controle. (Herdado de Control)
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos nesse controle têm estado de controle. (Herdado de Control)
IsEnabled	Obtém um valor que indica se o controle está habilitado. (Herdado de WebControl)
IsTrackingViewState	Obtém um valor que indica se o controle do servidor está salvando alterações em seu estado de exibição. (Herdado de Control)
IsViewStateEnabled	Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control)
LoadViewStateByID	Obtém um valor que indica se o controle participa no carregamento de seu estado de exibição ID em vez de índice. (Herdado de Control)
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
OnClientClick	Obtém ou define o script do lado do cliente que é executado quando o evento de Click um Button controle é acionado.
Page	Obtém uma referência à Page instância que contém o controle do servidor. (Herdado de Control)
Parent	Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página. (Herdado de Control)
PostBackUrl	Obtém ou define a URL da página a ser postada na página atual quando o Button controle é clicado.
RenderingCompatibility	Obtém um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
Site	Obtém informações sobre o contêiner que hospeda o controle atual quando renderizado em uma superfície de design. (Herdado de Control)
SkinID	Obtém ou define a pele a ser aplicada ao controle. (Herdado de WebControl)
Style	Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle do servidor Web. (Herdado de WebControl)
SupportsDisabledAttribute	Obtém um valor que indica se o controle deve definir o `disabled` atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controle é `false`. (Herdado de WebControl)
TabIndex	Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl)
TagKey	Obtém o HtmlTextWriterTag valor que corresponde a esse controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
TagName	Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
TemplateControl	Obtém ou define uma referência ao modelo que contém esse controle. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual. (Herdado de Control)
Text	Obtém ou define a legenda de texto exibida no Button controle.
ToolTip	Obtém ou define o texto exibido quando o ponteiro do mouse passa o mouse sobre o controle do servidor Web. (Herdado de WebControl)
UniqueID	Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor. (Herdado de Control)
UseSubmitBehavior	Obtém ou define um valor que indica se o Button controle usa o mecanismo de envio do navegador cliente ou o mecanismo de postback ASP.NET.
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de valores potencialmente perigosos. (Herdado de Control)
ValidationGroup	Obtém ou define o grupo de controles para o qual o Button controle causa validação quando ele é remetido ao servidor.
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o StateBag objeto não diferencia maiúsculas de minúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo de estado de exibição desse controle. (Herdado de Control)
Visible	Obtém ou define um valor que indica se um controle de servidor é renderizado como interface do usuário na página. (Herdado de Control)
Width	Obtém ou define a largura do controle do servidor Web. (Herdado de WebControl)

Métodos

Nome	Description
AddAttributesToRender(HtmlTextWriter)	Adiciona os atributos do Button controle ao fluxo de saída para renderização no cliente.
AddedControl(Control, Int32)	Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor. (Herdado de Control)
ApplyStyle(Style)	Copia todos os elementos nãoblank do estilo especificado para o controle da Web, substituindo quaisquer elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos de página ao controle. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor armazenado em ClientID cache como `null`. (Herdado de Control)
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle do servidor. (Herdado de Control)
ClearChildState()	Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle do servidor. (Herdado de Control)
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit. (Herdado de Control)
CopyBaseAttributes(WebControl)	Copia as propriedades não encapsuladas pelo Style objeto do controle de servidor Web especificado para o controle do servidor Web do qual esse método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
CreateChildControls()	Chamado pela estrutura de página ASP.NET para notificar os controles de servidor que usam a implementação baseada em composição para criar quaisquer controles filho que eles contenham em preparação para postar de volta ou renderização. (Herdado de Control)
CreateControlCollection()	Cria um novo ControlCollection objeto para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control)
CreateControlStyle()	Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas ao estilo. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
DataBind()	Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho. (Herdado de Control)
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento. (Herdado de Control)
DataBindChildren()	Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control)
Dispose()	Permite que um controle de servidor execute a limpeza final antes de ser liberado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento em tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controle do servidor contém controles filho. Se isso não acontecer, ele criará controles filho. (Herdado de Control)
EnsureID()	Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String, Int32)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o especificado `id` e um inteiro, especificado no parâmetro, que `pathOffset` ajuda na pesquisa. Você não deve substituir essa versão do FindControl método. (Herdado de Control)
FindControl(String)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado `id` . (Herdado de Control)
Focus()	Define o foco de entrada como um controle. (Herdado de Control)
GetDesignModeState()	Obtém dados de tempo de design para um controle. (Herdado de Control)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetPostBackOptions()	Cria um PostBackOptions objeto que representa o Button comportamento de postback do controle.
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Retorna a parte prefixada da UniqueID propriedade do controle especificado. (Herdado de Control)
HasControls()	Determina se o controle do servidor contém controles filho. (Herdado de Control)
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho. (Herdado de Control)
IsLiteralContent()	Determina se o controle do servidor contém apenas conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo SaveControlState() método. (Herdado de Control)
LoadViewState(Object)	Restaura informações de estado de exibição de uma solicitação anterior que foi salva com o SaveViewState() método. (Herdado de WebControl)
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, é mapeado. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MergeStyle(Style)	Copia todos os elementos nãoblank do estilo especificado para o controle da Web, mas não substituirá nenhum elemento de estilo existente do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controle do servidor é passado para a hierarquia de controle do servidor de interface do usuário da página. (Herdado de Control)
OnClick(EventArgs)	Gera o Click evento do Button controle.
OnCommand(CommandEventArgs)	Gera o Command evento do Button controle.
OnDataBinding(EventArgs)	Aciona o evento DataBinding. (Herdado de Control)
OnInit(EventArgs)	Aciona o evento Init. (Herdado de Control)
OnLoad(EventArgs)	Aciona o evento Load. (Herdado de Control)
OnPreRender(EventArgs)	Determina se o botão foi clicado antes da renderização no cliente.
OnPreRender(EventArgs)	Aciona o evento PreRender. (Herdado de Control)
OnUnload(EventArgs)	Aciona o evento Unload. (Herdado de Control)
OpenFile(String)	Obtém um Stream usado para ler um arquivo. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui todas as fontes do evento e suas informações ao pai do controle. (Herdado de Control)
RaisePostBackEvent(String)	Gera eventos para o Button controle quando ele é postagem de volta para o servidor.
RemovedControl(Control)	Chamado depois que um controle filho é removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Renderiza o controle para o gravador HTML especificado. (Herdado de WebControl)
RenderBeginTag(HtmlTextWriter)	Renderiza a marca de abertura HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
RenderChildren(HtmlTextWriter)	Gera o conteúdo dos filhos de um controle de servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Renderiza o conteúdo do controle para o gravador especificado.
RenderControl(HtmlTextWriter, ControlAdapter)	Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a marca de fechamento HTML do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
ResolveAdapter()	Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control)
ResolveClientUrl(String)	Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL em uma que é utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Salva as alterações de estado do controle do servidor que ocorreram desde o momento em que a página foi postada de volta no servidor. (Herdado de Control)
SaveViewState()	Salva qualquer estado modificado após a invocação do TrackViewState() método. (Herdado de WebControl)
SetDesignModeState(IDictionary)	Define dados de tempo de design para um controle. (Herdado de Control)
SetRenderMethodDelegate(RenderMethod)	Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control)
SetTraceData(Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz com que o controle rastreie as alterações no estado de exibição para que elas possam ser armazenadas na propriedade do ViewState objeto. (Herdado de WebControl)

Eventos

Nome	Description
Click	Ocorre quando o Button controle é clicado.
Command	Ocorre quando o Button controle é clicado.
DataBinding	Ocorre quando o controle do servidor é associado a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida do controle do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controle do servidor é carregado no Page objeto. (Herdado de Control)
PreRender	Ocorre depois que o Control objeto é carregado, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controle do servidor é descarregado da memória. (Herdado de Control)

Implantações explícitas de interface

Nome	Description
IAttributeAccessor.GetAttribute(String)	Obtém um atributo do controle Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controle Web como o nome e o valor especificados. (Herdado de WebControl)
IControlBuilderAccessor.ControlBuilder	Para obter uma descrição deste membro, consulte ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição deste membro, consulte GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição deste membro, consulte SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição deste membro, consulte UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição deste membro, consulte DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição deste membro, consulte HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para obter uma descrição deste membro, consulte Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição deste membro, consulte HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição deste membro, consulte AddParsedSubObject(Object). (Herdado de Control)
IPostBackEventHandler.RaisePostBackEvent(String)	Gera eventos para o Button controle quando ele é postagem de volta para o servidor.

Métodos de Extensão

Nome	Description
FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados para o controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatável para o controle de dados que contém.

Aplica-se a

Confira também

Comentários

Esta página foi útil?

Partilhar via

Button Classe

Definição

Exemplos

Comentários

Introdução

Eventos de servidor e comportamento de postback de botão

Manipulando eventos de botão no script do cliente

Controles de botão e validação

Botões em controles de dados

Associando dados aos controles

Usando botões com controles UpdatePanel

Sintaxe declarativa

Construtores

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Métodos de Extensão

Aplica-se a

Confira também

Comentários