Share via

LinkButton controle de servidor Web Declarative sintaxe

  • Artigo

Cria um botão de estilo hiperlink em uma página de Web Forms.

<asp:LinkButton
    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"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

Comentários

Use o LinkButton controle para criar um botão de estilo hiperlink em uma página de Web Forms. Especificar o texto para exibir o LinkButton controle por uma das configurações do Text propriedade ou colocando o texto entre as Rótulos de abertura e fechamento das LinkButton controle. Você pode criar um botão de envio ou um botão de comando.

ObservaçãoObservação:

O LinkButton controle a mesma aparência que tem um HyperLink controlar, mas tem a mesma funcionalidade de um Button controle. Use o HyperLink controle se você deseja vincular a outra página da Web quando o controle é clicado.

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

Definindo o CommandName propriedade, você pode associar um nome de comando com o botão de comando, sistema autônomo Sort. Isso permite que você crie vários LinkButton controles em uma Web da página e determinar programaticamente qual LinkButton controle é clicado. Você também pode usar o CommandArgument propriedade com um botão de comando 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 ao controle programaticamente as ações executadas quando o botão de comando é clicado.

ObservaçãoObservação:

O LinkButton controle processa JavaScript no navegador cliente. O navegador do cliente deve ter o JavaScript habilitado para este controle para funcionar corretamente. Para obter mais informações sobre script de cliente, consulte Script de Cliente em Páginas da Web ASP.NET Por padrão, a validação de página é executada quando um LinkButton 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 LinkButton controle precisa desabilitar esse comportamento, sistema autônomo um reset botão, conjunto o CausesValidation propriedade para false.

Aviso

O texto não é codificado antes que seja exibido em HTML a Controle LinkButton Isso torna possível incorporar o script nas Rótulos HTML no texto. Se os valores para o controle provenientes da entrada do usuário, certifique-se de validar os valores para ajudar a evitar vulnerabilidades de segurança.

Command botões (sistema autônomo LinkButton controles) 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.

Para obter informações detalhadas sobre o LinkButton Propriedades e eventos de controle de servidor de Web, consulte o LinkButton documentação da classe.

Exemplo

O exemplo a seguir demonstra como usar um LinkButton controle para exibir uma mensagem quando o controle é clicado.

<%@ 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>LinkButton Example</title>
<script language="VB" runat="server">

      Sub LinkButton_Click(sender As Object, e As EventArgs) 
         Label1.Text = "You clicked the link button"
      End Sub

   </script>

</head>
<body>

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

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>


<%@ 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>LinkButton Example</title>
<script language="C#" runat="server">

      void LinkButton_Click(Object sender, EventArgs e) 
      {
         Label1.Text="You clicked the link button";
      }

   </script>

</head>
<body>

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

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>


<%@ Page Language="JScript" 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>LinkButton Example</title>
<script language="JSCRIPT" runat="server">

      function LinkButton_Click(sender : Object, e : EventArgs){
         Label1.Text = "You clicked the link button"
      }

   </script>

</head>
<body>

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

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>

Consulte também

Referência

LinkButton

Outros recursos

controle de servidor Web sintaxe