通过

LinkButton Web 服务器控件声明性语法

  • 项目

更新：2007 年 11 月

在 Web 窗体页上创建超级链接样式按钮。

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

备注

使用 LinkButton 控件在 Web 窗体页上创建超链接样式按钮。通过设置 Text 属性或将文本放置在 LinkButton 控件的开始标记和结束标记之间，指定要在 LinkButton 控件中显示的文本。可以创建“提交”按钮或“命令”按钮。

说明：

LinkButton 控件的外观与 HyperLink 控件相同，但其功能与 Button 控件相同。如果要在单击控件时链接到另一个网页，请使用 HyperLink 控件。

submit 按钮没有与之关联的命令名，它只是将网页发送回服务器。默认情况下，LinkButton 控件是一个 submit 按钮。可以为 Click 事件提供事件处理程序，以编程方式控制单击 submit 按钮时执行的操作。

通过设置 CommandName 属性，可以将命令名与命令按钮（如 Sort）相关联。这使您能够在一个网页上创建多个 LinkButton 控件，并以编程方式确定单击的 LinkButton 控件。也可以将 CommandArgument 属性与命令按钮一起使用，以提供关于要执行的命令按钮（如 Ascending）的附加信息。可以为 Command 事件提供事件处理程序，以编程方式控制单击命令按钮时执行的操作。

说明：

LinkButton 控件在客户端浏览器上呈现 JavaScript。客户端浏览器必须启用了 JavaScript，此控件才能正常运行。有关客户端脚本的更多信息，请参见 ASP.NET 网页中的客户端脚本。默认情况下，单击 LinkButton 控件时执行页验证。页验证确定与该页上验证控件关联的输入控件是否通过该验证控件指定的验证规则。如果 LinkButton 控件需要禁用此行为（如 reset 按钮），请将 CausesValidation 属性设置为 false。
警告：

文本在 LinkButton 控件中显示之前并非 HTML 编码形式。这使得可以在文本中的 HTML 标记中嵌入脚本。如果控件的值是由用户输入的，请务必要对输入值进行验证以防止出现安全漏洞。

Command 按钮（如 LinkButton 控件）经常在模板化控件中用于将操作传递给父控件。例如，在 DataList 中进行选择或在 FormView 中更改模式。

有关 LinkButton Web 服务器控件的属性和事件的详细信息，请参见 LinkButton 类文档。

示例

下面的示例演示如何使用 LinkButton 控件在单击控件时显示消息。

<%@ 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>

请参见

参考

LinkButton

其他资源

Web 服务器控件语法