Botão controle de servidor Web Declarative sintaxe

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

<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"
/>

Comentários

The Button controle permite que você criar um botão de ação a página de Web Forms. Há dois tipos de botões que podem ser criados: a submit botão ou uma command botão.

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

A command botão tem um nome de comando associado ao botão (sistema autônomo Sort), definindo o CommandName propriedade. Isso permite que você crie vários Button controles em uma Web Forms da página e determinar programaticamente qual Button controle é clicado em evento manipulador para o Command evento. Você também pode usar o CommandArgument propriedade com um command botão para obter informações adicionais sobre o comando Executar sistema autônomo fornecer Ascending. Você pode fornecer um manipulador de eventos para o Command evento programaticamente controle as ações executadas quando o command botão é clicado.

Command botões são freqüentemente usados em controles modelados para comunicar-se uma ação para o controle pai, por exemplo, a seleção em um DataList ou alterando o modo em uma FormView.

Por padrão, validação de página é executada quando um Button controle é clicado. Validação da página determina se os controles de entrada associados a um controle de validação na página passam as regras de validação especificadas pelo controle de validação. Se você tiver um Button controle precisa desabilitar esse comportamento, sistema autônomo um reset botão, conjunto o CausesValidation propriedade para false.

Observação:
Porque o <asp:Button> elemento não tem conteúdo, você pode fechar a marca com /> em vez de uma marca de fechamento separada.

Para especificar a legenda é exibida no Button controle, defina o Text propriedade.

Para obter informações detalhadas sobre o Button Propriedades do controle e eventos, consulte o Button documentação.

Exemplo

O exemplo a seguir demonstra a declaração para um submit controle de botão em um arquivo.aspx.

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

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

O exemplo a seguir demonstra a declaração para um command controle de botão em um arquivo.aspx.

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

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

O exemplo a seguir mostra um evento-manipulação de método que obtém o clicar do botão e exibe as informações passadas do botão no seu CommandName e CommandArgument Propriedades.

Sub CommandBtn_Click(ByVal sender As Object, ByVal e As CommandEventArgs)
    Message.Text = "You clicked the " & e.CommandName & _
                   " - " & e.CommandArgument & " button."
End Sub

void CommandBtn_Click(Object sender, CommandEventArgs e)
{
    Message.Text = "You clicked the " + e.CommandName +
                   " - " + e.CommandArgument + " button.";
}

Consulte também

Referência

Button

Outros recursos

controle de servidor Web sintaxe