LinkButton 类

项目
08/17/2007

在网页上显示超链接样式的按钮控件。

**命名空间:**System.Web.UI.WebControls
**程序集:**System.Web（在 system.web.dll 中）

语法

声明
Public Class LinkButton
    Inherits WebControl
    Implements IButtonControl, IPostBackEventHandler
用法
Dim instance As LinkButton

public class LinkButton : WebControl, IButtonControl, IPostBackEventHandler

public ref class LinkButton : public WebControl, IButtonControl, IPostBackEventHandler

public class LinkButton extends WebControl implements IButtonControl, IPostBackEventHandler

public class LinkButton extends WebControl implements IButtonControl, IPostBackEventHandler

备注

使用 LinkButton 控件可在网页上创建超链接样式的按钮。LinkButton 控件的外观与 HyperLink 控件相同，但功能与 Button 控件相同。如果单击控件时要链接到另一个网页，可以考虑使用 HyperLink 控件。

提示

LinkButton 控件将 JavaScript 呈现给客户端浏览器。客户端浏览器必须启用 JavaScript 才能使该控件正常工作。有关客户端脚本的更多信息，请参见 ASP.NET 网页中的客户端脚本。

既可以创建“提交”按钮，也可以创建“命令”按钮。“提交”按钮没有关联的命令名。该按钮仅将网页回发给服务器。默认情况下，LinkButton 控件是“提交”按钮。可以为 Click 事件提供事件处理程序，以便以编程方式控制在用户单击“提交”按钮时执行的操作。另一方面，“命令”按钮有关联的命令名称，如 Sort。设置 CommandName 属性以指定命令名。这使您可以在一个网页上创建多个 LinkButton 控件，并以编程方式确定单击了哪个 LinkButton 控件。还可以对“命令”按钮使用 CommandArgument 属性，以提供有关要执行的命令的附加信息，如指定升序。另外，也可以为 Command 事件提供事件处理程序，以便以编程方式控制在单击“命令”按钮时执行的操作。

警告

此控件可用来显示用户输入，而该输入可能包含恶意的客户端脚本。在应用程序中显示从客户端发送来的任何信息之前，请检查它们是否包含可执行脚本、SQL 语句或其他代码。ASP.NET 提供输入请求验证功能以阻止用户输入中的脚本和 HTML。还提供验证服务器控件以判断用户输入。有关更多信息，请参见验证服务器控件语法。

默认情况下，单击 LinkButton 控件时执行页验证。页验证确定页上与验证控件关联的输入控件是否均通过该验证控件所指定的验证规则。若要禁止执行页验证，请将 CausesValidation 属性设置为 false。

辅助功能

默认情况下为此控件呈现的标记可能不符合 Web 内容辅助功能准则 1.0 (WCAG) 中优先级为 1 的准则等辅助功能标准。有关此控件的辅助功能支持的详细信息，请参见 ASP.NET 控件和辅助功能。

主题	位置
如何：向 Web 窗体页添加按钮 Web 服务器控件 (Visual Studio)	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中创建和使用 ASP.NET 母版页	在 Visual Studio 中构建 ASP .NET Web 应用程序
如何：响应用户在 BulletedList Web 服务器控件中的单击 (Visual Studio)	在 Visual Studio 中构建 ASP .NET Web 应用程序
演练：在 Visual Web Developer 中创建和使用 ASP.NET 母版页	使用 Visual Web Developer 生成应用程序
如何：响应客户端脚本中的 Button Web 服务器控件事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应用户在 BulletedList Web 服务器控件中的单击 (Visual Studio)	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：在 ASP.NET Web 服务器控件上设置焦点	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应 Button Web 服务器控件事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应数据绑定控件中的按钮事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应客户端脚本中的 Button Web 服务器控件事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应用户在 BulletedList Web 服务器控件中的单击 (Visual Studio)	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：在 ASP.NET Web 服务器控件上设置焦点	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加按钮 Web 服务器控件 (Visual Studio)	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应 Button Web 服务器控件事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应数据绑定控件中的按钮事件	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：向 Web 窗体页添加按钮 Web 服务器控件 (Visual Studio)	在 Visual Studio 中生成 ASP .NET Web 应用程序
如何：响应客户端脚本中的 Button Web 服务器控件事件	生成 ASP .NET Web 应用程序
如何：在 ASP.NET Web 服务器控件上设置焦点	生成 ASP .NET Web 应用程序
如何：响应 Button Web 服务器控件事件	生成 ASP .NET Web 应用程序
如何：响应数据绑定控件中的按钮事件	生成 ASP .NET Web 应用程序

示例

下面的示例说明如何创建 LinkButton 控件，该控件在链接被单击时在 Label 控件中显示文本。

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

   <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 runat=server>

      <h3>LinkButton Example</h3>
 
      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Name="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>
         
      <p>
 
      <asp:Label id=Label1 runat=server />
         
   </form>
 
</body>
</html>

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

   <script language="C#" runat="server">
 
      void LinkButton_Click(Object sender, EventArgs e) 
      {
         Label1.Text="You clicked the link button";
      }
 
   </script>
 
</head>
<body>
 
   <form runat=server>

      <h3>LinkButton Example</h3>
 
      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Name="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>
         
      <p>
 
      <asp:Label id=Label1 runat=server />
         
   </form>
 
</body>
</html>

<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>

   <script language="JSCRIPT" runat="server">
 
      function LinkButton_Click(sender : Object, e : EventArgs){
         Label1.Text = "You clicked the link button"
      }
 
   </script>
 
</head>
<body>
 
   <form runat=server>

      <h3>LinkButton Example</h3>
 
      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Name="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>
         
      <p>
 
      <asp:Label id=Label1 runat=server />
         
   </form>
 
</body>
</html>

.NET Framework 安全性

AspNetHostingPermission 用于在宿主环境中进行操作。要求值：LinkDemand；权限值：Minimal。
AspNetHostingPermission 用于在宿主环境中进行操作。要求值：InheritanceDemand；权限值：Minimal。

继承层次结构

System.Object
   System.Web.UI.Control
     System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.LinkButton

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

LinkButton 成员
 System.Web.UI.WebControls 命名空间
 Button 类
 ImageButton 类
 HyperLink 类

其他资源

Button Web 服务器控件
 ASP.NET 网页中的客户端脚本