Button 类

定义

命名空间:: System.Web.UI.WebControls

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

在网页上显示一个按下按钮控件。

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

继承: Object

Control

WebControl
Button

实现: IPostBackEventHandler IButtonControl

示例

下面的代码示例演示如何创建一个提交 Button 控件，用于将网页内容发回服务器。

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

下面的代码示例演示如何创建对列表进行排序的 Command Button 控件。

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

注解

在本主题中：

介绍
按钮回发行为和服务器事件
在客户端脚本中处理按钮事件
按钮控件和验证
数据控件中的按钮
将数据绑定到控件
将按钮与 UpdatePanel 控件配合使用
声明性语法

介绍

使用 Button 控件在网页上创建一个推送按钮，允许用户将页面发布到服务器。该控件在服务器代码中触发事件，你可以处理该事件以响应回发。它还可以在客户端脚本中引发一个事件，可以在发布页面之前处理该事件，也可以运行该事件，然后取消提交页面。

注释

ASP.NET 包括多种按钮控件，每个控件在网页上以不同的方式显示。 Button它们是一个控件，它呈现为一个按下按钮;LinkButton控件，它呈现为链接;以及ImageButton呈现为图像的控件;以及ImageMap控件，用于创建具有用户可以单击的热点的图形。默认情况下，单击时，所有按钮控件都提交页面。还可以使用 HtmlButton 控件 HtmlInputButton 在服务器代码中可编程的页面上创建按钮。有关 HTML 和 Web 服务器控件之间的差异的详细信息，请参阅 ASP.NET Web 服务器控件概述。

默认情况下， Button 控件是“提交”按钮。 “提交”按钮没有与该按钮关联的命令名称（由 CommandName 属性指定），并且只是将网页发回服务器。可以为事件提供事件处理程序 Click ，以编程方式控制单击“提交”按钮时执行的操作。

命令按钮具有与按钮关联的命令名称，例如 Sort，通过设置 CommandName 属性。这样就可以在网页上创建多个 Button 控件，并以编程方式确定单击哪个 Button 控件。还可以将 CommandArgument 属性与命令按钮一起使用，以提供有关要执行的命令的其他信息，例如 Ascending。可以为事件提供事件处理程序 Command ，以编程方式控制单击命令按钮时执行的操作。

按钮回发行为和服务器事件

当用户单击任何 Web 服务器控件按钮时，页面将发送到服务器。这会导致处理网页，并在基于服务器的代码中引发任何挂起的事件。当所有页面和控件处理完成时，页面将再次呈现给浏览器。

这些按钮可以引发自己的 Click 事件或 Command 事件，可以使用基于服务器的代码来处理这些事件。这不同于传统 HTML 页面或基于客户端的 Web 应用程序中的事件，其中按钮 onclick 的事件使用在客户端中运行的 JavaScript 进行处理。有关详细信息，请参阅 ASP.NET Web 窗体服务器控制事件模型。

当用户单击按钮控件时，页面将发回服务器。默认情况下，页面将发回其自身，

可以将按钮配置为将当前页发布到另一页。这对于创建多页表单非常有用。有关详细信息，请参阅 ASP.NET Web 窗体中的跨页发布。

在客户端脚本中处理按钮事件

按钮控件可以同时引发服务器事件和客户端事件。服务器事件在回发后发生，这些事件在为页面编写的服务器端代码中进行处理。客户端事件在客户端脚本中处理，通常是 ECMAScript （JavaScript），并在提交页面之前引发。通过将客户端事件添加到 ASP.NET 按钮控件，可以执行诸如在提交页面之前显示确认对话框等任务，并可能取消提交。有关详细信息，请参阅 ASP.NET 网页中的客户端脚本以及如何：响应客户端脚本中的按钮 Web 服务器控制事件。

你可能还希望 Button 该控件还使用客户端脚本执行回发（而不仅仅是执行 HTTP POST 操作）。如果要以编程方式操作回发，例如将其附加到页面上的其他元素，这非常有用。可以将控件UseSubmitBehavior的属性设置为Buttontrue使Button控件使用基于客户端脚本的回发。

按钮控件和验证

如果页面包含 ASP.NET 验证程序控件，则默认情况下，单击按钮控件会导致验证程序控件执行其检查。如果为验证程序控件启用了客户端验证，则如果验证检查失败，则不会提交页面。

下表描述了按钮控件支持的属性，使你能够更准确地控制验证过程。

财产	说明
CausesValidation	指定单击按钮是否还会执行验证检查。将此属性设置为 `false` 阻止验证检查。
ValidationGroup	使你能够在单击按钮时指定页面上调用的验证程序。如果未建立验证组，按钮单击将调用页面上的所有验证程序。

有关详细信息，请参阅 ASP.NET 网页中的验证用户输入。

数据控件中的按钮

按钮 Web 服务器控件通常用于数据控件，例如，DataList GridView和Repeater列表控件。在这些情况下，通常不会直接响应按钮单击事件。相反，数据控件中的按钮会引发特定于数据控件的事件。例如，在控件中 DataList ，按钮可能会引发 DataList 控件 ItemCommand 的事件，而不是引发 Button 控件 Click 的事件。

由于数据绑定列表控件可以包含多个按钮，因此可以设置按钮 CommandArgument 的属性以指定要作为事件的一部分传递的值。然后，可以测试此参数以查看单击了哪个按钮。

将数据绑定到控件

可以将按钮 Web 服务器控件绑定到数据源，以便动态控制其属性设置。例如，可以使用数据绑定设置按钮 Text 的属性。

将按钮与 UpdatePanel 控件配合使用

通过部分页面呈现，无需回发即可刷新页面的某些部分。 UpdatePanel 通过控件可以标记参与部分页面呈现的页面部分。默认情况下，控件（包括Button控件）内的UpdatePanel控件的行为是执行异步回发而不是回发。这会仅刷新回发来源的控件的内容 UpdatePanel 。

除了控件内UpdatePanel控件的方案Button外，还可以在以下方案中将控件与控件一Button起使用UpdatePanel：

将 Button 控件外部 UpdatePanel 的控件定义为 AsyncPostBackTrigger 该面板的控件。单击按钮时，它会执行异步回发并刷新面板的内容。
将 Button 控件内的 UpdatePanel 控件定义为 PostBackTrigger 面板的控件。单击按钮时，即使它位于控件内部 UpdatePanel ，它也会执行回发。

有关部分页面呈现和使用 UpdatePanel 控件的详细信息，请参阅 UpdatePanel 控件概述和 Partial-Page 呈现概述。

声明性语法

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

构造函数

名称	说明
Button()	初始化 Button 类的新实例。

属性

名称	说明
AccessKey	获取或设置访问密钥，使你能够快速导航到 Web 服务器控件。 (继承自 WebControl)
Adapter	获取控件的特定于浏览器的适配器。 (继承自 Control)
AppRelativeTemplateSourceDirectory	获取或设置包含此控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control)
Attributes	获取不对应于控件上的属性的任意属性（仅用于呈现）的集合。 (继承自 WebControl)
BackColor	获取或设置 Web 服务器控件的背景色。 (继承自 WebControl)
BindingContainer	获取包含此控件的数据绑定的控件。 (继承自 Control)
BorderColor	获取或设置 Web 控件的边框颜色。 (继承自 WebControl)
BorderStyle	获取或设置 Web 服务器控件的边框样式。 (继承自 WebControl)
BorderWidth	获取或设置 Web 服务器控件的边框宽度。 (继承自 WebControl)
CausesValidation	获取或设置一个值，该值指示在单击控件时 Button 是否执行验证。
ChildControlsCreated	获取一个值，该值指示是否已创建服务器控件的子控件。 (继承自 Control)
ClientID	获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control)
ClientIDMode	获取或设置用于生成属性值的 ClientID 算法。 (继承自 Control)
ClientIDSeparator	获取一个表示属性中使用的 ClientID 分隔符的字符值。 (继承自 Control)
CommandArgument	获取或设置传递给 Command 事件的可选参数以及关联的 CommandName参数。
CommandName	获取或设置与 Button 传递给 Command 事件的控件关联的命令名称。
Context	HttpContext获取与当前 Web 请求的服务器控件关联的对象。 (继承自 Control)
Controls	获取一个 ControlCollection 对象，该对象代表 UI 层次结构中指定服务器控件的子控件。 (继承自 Control)
ControlStyle	获取 Web 服务器控件的样式。此属性主要由控件开发人员使用。 (继承自 WebControl)
ControlStyleCreated	获取一个值，该值 Style 指示是否已为 ControlStyle 属性创建对象。此属性主要由控件开发人员使用。 (继承自 WebControl)
CssClass	获取或设置由客户端上的 Web 服务器控件呈现的级联样式表（CSS）类。 (继承自 WebControl)
DataItemContainer	获取对命名容器的引用（如果命名容器实现 IDataItemContainer）。 (继承自 Control)
DataKeysContainer	获取对命名容器的引用（如果命名容器实现 IDataKeysControl）。 (继承自 Control)
DesignMode	获取一个值，该值指示控件是否在设计图面上使用。 (继承自 Control)
Enabled	获取或设置一个值，该值指示是否启用 Web 服务器控件。 (继承自 WebControl)
EnableTheming	获取或设置一个值，该值指示主题是否应用于此控件。 (继承自 WebControl)
EnableViewState	获取或设置一个值，该值指示服务器控件是否将视图状态及其包含的任何子控件的视图状态保存到请求客户端。 (继承自 Control)
Events	获取控件的事件处理程序委托的列表。此属性为只读。 (继承自 Control)
Font	获取与 Web 服务器控件关联的字体属性。 (继承自 WebControl)
ForeColor	获取或设置 Web 服务器控件的前景色（通常是文本的颜色）。 (继承自 WebControl)
HasAttributes	获取一个值，该值指示控件是否设置了属性。 (继承自 WebControl)
HasChildViewState	获取一个值，该值指示当前服务器控件的子控件是否具有保存的视图状态设置。 (继承自 Control)
Height	获取或设置 Web 服务器控件的高度。 (继承自 WebControl)
ID	获取或设置分配给服务器控件的编程标识符。 (继承自 Control)
IdSeparator	获取用于分隔控件标识符的字符。 (继承自 Control)
IsChildControlStateCleared	获取一个值，该值指示此控件中包含的控件是否具有控件状态。 (继承自 Control)
IsEnabled	获取一个值，该值指示是否启用控件。 (继承自 WebControl)
IsTrackingViewState	获取一个值，该值指示服务器控件是否正在保存对其视图状态的更改。 (继承自 Control)
IsViewStateEnabled	获取一个值，该值指示是否为此控件启用视图状态。 (继承自 Control)
LoadViewStateByID	获取一个值，该值指示控件是否参与加载其视图状态，而不是 ID 索引。 (继承自 Control)
NamingContainer	获取对服务器控件命名容器的引用，该容器创建唯一的命名空间，用于区分具有相同 ID 属性值的服务器控件。 (继承自 Control)
OnClientClick	获取或设置在引发控件Click事件时Button执行的客户端脚本。
Page	获取对 Page 包含服务器控件的实例的引用。 (继承自 Control)
Parent	获取对页面控件层次结构中服务器控件的父控件的引用。 (继承自 Control)
PostBackUrl	获取或设置单击控件时 Button 要从当前页发布到的页面的 URL。
RenderingCompatibility	获取一个值，该值指定呈现的 HTML 将与 ASP.NET 版本兼容。 (继承自 Control)
Site	获取有关在设计图面上呈现时承载当前控件的容器的信息。 (继承自 Control)
SkinID	获取或设置要应用于控件的皮肤。 (继承自 WebControl)
Style	获取文本属性的集合，该属性将在 Web 服务器控件的外部标记上呈现为样式属性。 (继承自 WebControl)
SupportsDisabledAttribute	获取一个值，该值指示当控件的属性为控件的属性时，控件是否应将呈现的 IsEnabled HTML 元素的属性`false`设置为`disabled`“disabled”。 (继承自 WebControl)
TabIndex	获取或设置 Web 服务器控件的选项卡索引。 (继承自 WebControl)
TagKey	HtmlTextWriterTag获取与此 Web 服务器控件对应的值。此属性主要由控件开发人员使用。 (继承自 WebControl)
TagName	获取控件标记的名称。此属性主要由控件开发人员使用。 (继承自 WebControl)
TemplateControl	获取或设置对包含此控件的模板的引用。 (继承自 Control)
TemplateSourceDirectory	获取包含当前服务器控件的 Page 虚拟 UserControl 目录。 (继承自 Control)
Text	获取或设置控件中显示的 Button 文本标题。
ToolTip	获取或设置鼠标指针悬停在 Web 服务器控件上时显示的文本。 (继承自 WebControl)
UniqueID	获取服务器控件的唯一分层限定标识符。 (继承自 Control)
UseSubmitBehavior	获取或设置一个值，该值指示控件是 Button 使用客户端浏览器的提交机制还是 ASP.NET 回发机制。
ValidateRequestMode	获取或设置一个值，该值指示控件是否检查浏览器的客户端输入是否存在潜在危险值。 (继承自 Control)
ValidationGroup	获取或设置控件在其发回服务器时导致 Button 验证的控件组。
ViewState	获取状态信息的字典，该字典允许跨同一页的多个请求保存和还原服务器控件的视图状态。 (继承自 Control)
ViewStateIgnoresCase	获取一个值，该值指示对象是否 StateBag 不区分大小写。 (继承自 Control)
ViewStateMode	获取或设置此控件的视图状态模式。 (继承自 Control)
Visible	获取或设置一个值，该值指示服务器控件是否呈现为页面上的 UI。 (继承自 Control)
Width	获取或设置 Web 服务器控件的宽度。 (继承自 WebControl)

方法

名称	说明
AddAttributesToRender(HtmlTextWriter)	将控件的属性 Button 添加到输出流，以便在客户端上呈现。
AddedControl(Control, Int32)	在将子控件添加到 Controls 对象的集合 Control 后调用。 (继承自 Control)
AddParsedSubObject(Object)	通知服务器控件对元素（XML 或 HTML）进行了分析，并将该元素添加到服务器控件的对象 ControlCollection 。 (继承自 Control)
ApplyStyle(Style)	将指定样式的任何非空白元素复制到 Web 控件，覆盖该控件的任何现有样式元素。此方法主要由控件开发人员使用。 (继承自 WebControl)
ApplyStyleSheetSkin(Page)	将页面样式表中定义的样式属性应用于控件。 (继承自 Control)
BeginRenderTracing(TextWriter, Object)	开始对呈现数据进行设计时跟踪。 (继承自 Control)
BuildProfileTree(String, Boolean)	收集有关服务器控件的信息，并将其传送到 Trace 为页面启用跟踪时要显示的属性。 (继承自 Control)
ClearCachedClientID()	将缓存 ClientID 的值设置为 `null`。 (继承自 Control)
ClearChildControlState()	删除服务器控件的子控件的控件状态信息。 (继承自 Control)
ClearChildState()	删除所有服务器控件的子控件的视图状态和控件状态信息。 (继承自 Control)
ClearChildViewState()	删除所有服务器控件的子控件的视图状态信息。 (继承自 Control)
ClearEffectiveClientIDMode()	将 ClientIDMode 当前控件实例的属性和任何子控件的属性设置为 Inherit。 (继承自 Control)
CopyBaseAttributes(WebControl)	将对象未封装 Style 的属性从指定的 Web 服务器控件复制到从中调用此方法的 Web 服务器控件。此方法主要由控件开发人员使用。 (继承自 WebControl)
CreateChildControls()	ASP.NET 页面框架调用，以通知使用基于组合的实现创建任何子控件的服务器控件，以准备回发或呈现。 (继承自 Control)
CreateControlCollection()	创建一个新 ControlCollection 对象，用于保存服务器控件的子控件（文本控件和服务器）。 (继承自 Control)
CreateControlStyle()	创建类在内部用于实现所有样式相关属性的 WebControl 样式对象。此方法主要由控件开发人员使用。 (继承自 WebControl)
DataBind()	将数据源绑定到调用的服务器控件及其所有子控件。 (继承自 Control)
DataBind(Boolean)	将数据源绑定到已调用的服务器控件及其所有子控件，并提供引发 DataBinding 事件的选项。 (继承自 Control)
DataBindChildren()	将数据源绑定到服务器控件的子控件。 (继承自 Control)
Dispose()	使服务器控件能够在从内存释放之前执行最终清理。 (继承自 Control)
EndRenderTracing(TextWriter, Object)	结束呈现数据的设计时跟踪。 (继承自 Control)
EnsureChildControls()	确定服务器控件是否包含子控件。如果没有，它将创建子控件。 (继承自 Control)
EnsureID()	为未分配标识符的控件创建标识符。 (继承自 Control)
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
FindControl(String, Int32)	在当前命名容器中搜索具有指定 `id` 和整数的服务器控件（在参数中指定的 `pathOffset` 整数），这有助于搜索。不应重写此方法的 FindControl 此版本。 (继承自 Control)
FindControl(String)	使用指定 `id` 参数搜索服务器控件的当前命名容器。 (继承自 Control)
Focus()	将输入焦点设置为控件。 (继承自 Control)
GetDesignModeState()	获取控件的设计时数据。 (继承自 Control)
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetPostBackOptions()	创建一个 PostBackOptions 对象，该对象表示 Button 控件的回发行为。
GetRouteUrl(Object)	获取对应于一组路由参数的 URL。 (继承自 Control)
GetRouteUrl(RouteValueDictionary)	获取对应于一组路由参数的 URL。 (继承自 Control)
GetRouteUrl(String, Object)	获取对应于一组路由参数和路由名称的 URL。 (继承自 Control)
GetRouteUrl(String, RouteValueDictionary)	获取对应于一组路由参数和路由名称的 URL。 (继承自 Control)
GetType()	获取当前实例的 Type。 (继承自 Object)
GetUniqueIDRelativeTo(Control)	返回指定控件属性的前缀部分 UniqueID 。 (继承自 Control)
HasControls()	确定服务器控件是否包含任何子控件。 (继承自 Control)
HasEvents()	返回一个值，该值指示是为控件或任何子控件注册事件。 (继承自 Control)
IsLiteralContent()	确定服务器控件是否仅保留文本内容。 (继承自 Control)
LoadControlState(Object)	从方法保存 SaveControlState() 的上一页请求中还原控件状态信息。 (继承自 Control)
LoadViewState(Object)	从使用该方法保存 SaveViewState() 的上一个请求还原视图状态信息。 (继承自 WebControl)
MapPathSecure(String)	检索虚拟路径映射到的物理路径（绝对路径或相对路径）。 (继承自 Control)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
MergeStyle(Style)	将指定样式的任何非空白元素复制到 Web 控件，但不会覆盖该控件的任何现有样式元素。此方法主要由控件开发人员使用。 (继承自 WebControl)
OnBubbleEvent(Object, EventArgs)	确定服务器控件的事件是否传递页面的 UI 服务器控件层次结构。 (继承自 Control)
OnClick(EventArgs)	Click引发控件的事件Button。
OnCommand(CommandEventArgs)	Command引发控件的事件Button。
OnDataBinding(EventArgs)	引发 DataBinding 事件。 (继承自 Control)
OnInit(EventArgs)	引发 Init 事件。 (继承自 Control)
OnLoad(EventArgs)	引发 Load 事件。 (继承自 Control)
OnPreRender(EventArgs)	确定在客户端上呈现之前是否已单击该按钮。
OnPreRender(EventArgs)	引发 PreRender 事件。 (继承自 Control)
OnUnload(EventArgs)	引发 Unload 事件。 (继承自 Control)
OpenFile(String)	获取用于读取文件的一个 Stream 。 (继承自 Control)
RaiseBubbleEvent(Object, EventArgs)	将事件的任何源及其信息分配给控件的父级。 (继承自 Control)
RaisePostBackEvent(String)	在控件发回服务器时引发 Button 该控件的事件。
RemovedControl(Control)	从 Controls 对象的集合 Control 中删除子控件后调用。 (继承自 Control)
Render(HtmlTextWriter)	将控件呈现到指定的 HTML 编写器。 (继承自 WebControl)
RenderBeginTag(HtmlTextWriter)	将控件的 HTML 开始标记呈现给指定的编写器。此方法主要由控件开发人员使用。 (继承自 WebControl)
RenderChildren(HtmlTextWriter)	将服务器控件的子级的内容输出到所提供的 HtmlTextWriter 对象，该对象写入要呈现在客户端上的内容。 (继承自 Control)
RenderContents(HtmlTextWriter)	将控件的内容呈现给指定的编写器。
RenderControl(HtmlTextWriter, ControlAdapter)	使用提供的对象将服务器控件内容输出到所提供的HtmlTextWriter ControlAdapter对象。 (继承自 Control)
RenderControl(HtmlTextWriter)	将服务器控件内容输出到提供 HtmlTextWriter 的对象，并在启用跟踪时存储有关控件的跟踪信息。 (继承自 Control)
RenderEndTag(HtmlTextWriter)	将控件的 HTML 结束标记呈现到指定的编写器中。此方法主要由控件开发人员使用。 (继承自 WebControl)
ResolveAdapter()	获取负责呈现指定控件的控件适配器。 (继承自 Control)
ResolveClientUrl(String)	获取浏览器可以使用的 URL。 (继承自 Control)
ResolveUrl(String)	将 URL 转换为在请求客户端上可用 URL。 (继承自 Control)
SaveControlState()	保存自页面发回服务器后发生的任何服务器控件状态更改。 (继承自 Control)
SaveViewState()	保存调用方法后 TrackViewState() 修改的任何状态。 (继承自 WebControl)
SetDesignModeState(IDictionary)	设置控件的设计时数据。 (继承自 Control)
SetRenderMethodDelegate(RenderMethod)	分配事件处理程序委托以将服务器控件及其内容呈现为其父控件。 (继承自 Control)
SetTraceData(Object, Object, Object)	使用跟踪对象、跟踪数据键和跟踪数据值为呈现数据的设计时跟踪设置跟踪数据。 (继承自 Control)
SetTraceData(Object, Object)	使用跟踪数据键和跟踪数据值为呈现数据的设计时跟踪设置跟踪数据。 (继承自 Control)
ToString()	返回一个表示当前对象的字符串。 (继承自 Object)
TrackViewState()	使控件跟踪其视图状态的更改，以便这些更改可以存储在对象的 ViewState 属性中。 (继承自 WebControl)

活动

名称	说明
Click	单击控件时 Button 发生。
Command	单击控件时 Button 发生。
DataBinding	当服务器控件绑定到数据源时发生。 (继承自 Control)
Disposed	在从内存中释放服务器控件时发生，这是请求 ASP.NET 页时服务器控件生命周期的最后阶段。 (继承自 Control)
Init	在初始化服务器控件时发生，这是其生命周期中的第一步。 (继承自 Control)
Load	在将服务器控件加载到对象中 Page 时发生。 (继承自 Control)
PreRender	在 Control 加载对象但在呈现之前发生。 (继承自 Control)
Unload	从内存中卸载服务器控件时发生。 (继承自 Control)

显式接口实现

名称	说明
IAttributeAccessor.GetAttribute(String)	获取具有指定名称的 Web 控件的属性。 (继承自 WebControl)
IAttributeAccessor.SetAttribute(String, String)	将 Web 控件的属性设置为指定的名称和值。 (继承自 WebControl)
IControlBuilderAccessor.ControlBuilder	有关此成员的说明，请参阅 ControlBuilder。 (继承自 Control)
IControlDesignerAccessor.GetDesignModeState()	有关此成员的说明，请参阅 GetDesignModeState()。 (继承自 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	有关此成员的说明，请参阅 SetDesignModeState(IDictionary)。 (继承自 Control)
IControlDesignerAccessor.SetOwnerControl(Control)	有关此成员的说明，请参阅 SetOwnerControl(Control)。 (继承自 Control)
IControlDesignerAccessor.UserData	有关此成员的说明，请参阅 UserData。 (继承自 Control)
IDataBindingsAccessor.DataBindings	有关此成员的说明，请参阅 DataBindings。 (继承自 Control)
IDataBindingsAccessor.HasDataBindings	有关此成员的说明，请参阅 HasDataBindings。 (继承自 Control)
IExpressionsAccessor.Expressions	有关此成员的说明，请参阅 Expressions。 (继承自 Control)
IExpressionsAccessor.HasExpressions	有关此成员的说明，请参阅 HasExpressions。 (继承自 Control)
IParserAccessor.AddParsedSubObject(Object)	有关此成员的说明，请参阅 AddParsedSubObject(Object)。 (继承自 Control)
IPostBackEventHandler.RaisePostBackEvent(String)	在控件发回服务器时引发 Button 该控件的事件。

扩展方法

名称	说明
FindDataSourceControl(Control)	返回与指定控件的数据控件关联的数据源。
FindFieldTemplate(Control, String)	返回指定控件命名容器中指定列的字段模板。
FindMetaTable(Control)	返回包含数据控件的元表对象。

适用于

另请参阅

反馈

此页面是否有帮助？