共用方式為


Button 類別

定義

網頁上顯示按鈕控制。

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
繼承
實作

範例

以下程式碼範例示範如何建立 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>

以下程式碼範例示範如何建立一個用來排序清單的指令 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>

備註

本主題內容:

簡介

使用 Button 這個控制鍵在網頁上建立一個按鈕,讓使用者可以把頁面上傳到伺服器。 這個控制項會在伺服器程式碼中觸發一個事件,你可以處理它來回應回傳。 它也能在用戶端腳本中觸發事件,讓你在頁面發布前處理,或執行後取消頁面提交。

備註

ASP.NET 包含多種按鈕控制方式,每種按鈕在網頁上的呈現方式都不同。 它們分別是 Button 控制項,以按鈕方式渲染; LinkButton 控制項,以連結方式渲染;控制 ImageButton 項,以影像呈現;以及 ImageMap 控制項,讓你能建立包含熱點的圖形,使用者可以點擊。 預設情況下,所有按鈕控制在點擊時都會提交頁面。 你也可以用 HtmlButtonHtmlInputButton 控制項在頁面上建立可用伺服器程式碼編程的按鈕。 關於 HTML 與網頁伺服器控制項的差異,請參見 ASP.NET 網頁伺服器控制概述

預設情況下, Button 控制項是提交按鈕。 提交按鈕沒有由屬性指定的 CommandName 指令名稱,只是將網頁貼回伺服器。 你可以提供事件處理 Click 程式,讓事件在點擊提交按鈕時執行的動作由程式化控制。

指令按鈕會有一個與按鈕相關的命令名稱,例如 Sort,透過設定屬性 CommandName 來實現。 這讓你能在網頁上建立多個 Button 控制項,並以程式化方式決定點擊哪一個 Button 控制項。 你也可以使用 CommandArgument 該屬性搭配指令按鈕,提供關於執行指令的額外資訊,例如 Ascending。 你可以提供事件處理程序, Command 讓事件在點擊 Command 鍵時程式化控制執行的動作。

按鈕回貼行為與伺服器事件

當使用者點擊任何網頁伺服器控制按鈕時,該頁面會被傳送到伺服器。 這會使網頁被處理,並以伺服器端程式碼中提出任何待處理事件。 當所有頁面與控制處理完成後,該頁面會再次渲染給瀏覽器。

按鈕可以自行觸發 Click 事件或 Command 事件,你可以用伺服器端的程式碼來處理。 這與傳統 HTML 頁面或基於用戶端的網頁應用程式中的事件不同,後者 onclick 按鈕的事件是透過在客戶端執行的 JavaScript 來處理。 欲了解更多資訊,請參閱 ASP.NET 網頁表單伺服器控制事件模型

當使用者點擊按鈕控制項時,該頁面會被上傳回伺服器。 預設情況下,該頁面會自動上傳回自身,

你可以設定按鈕,將當前頁面發佈到另一個頁面。 這對於製作多頁表單很有幫助。 詳情請參閱 ASP.NET 網頁表單中的跨頁發布

在客戶端腳本中處理按鈕事件

按鍵控制可以同時引發伺服器事件和客戶端事件。 伺服器事件會在回傳後發生,並由你為頁面撰寫的伺服器端程式碼處理。 客戶端事件由客戶端腳本處理,通常是 ECMAScript(JavaScript),並在頁面提交前提出。 透過在 ASP.NET 按鈕控制中加入客戶端事件,你可以執行例如在提交頁面前顯示確認對話框等任務,甚至可能取消提交。 詳情請參閱 ASP.NET 網頁中的用戶端腳本如何回應用戶端腳本中的按鈕網頁伺服器控制事件

你也可能希望控制 Button 項同時使用用戶端腳本來執行回傳(而不是單純執行 HTTP POST 操作)。 如果你想程式化地操作回貼,例如將其附加到頁面上的其他元素,這會很有用。 你可以設定 Button 控制項 UseSubmitBehavior 的屬性, true 讓控制 Button 項使用基於客戶端腳本的回傳。

按鈕控制與驗證

如果頁面包含 ASP.NET 驗證控制項,預設點擊按鈕控制項會使驗證控制項執行檢查。 若驗證者控制項啟用客戶端驗證,若驗證檢查失敗,該頁面不會被提交。

下表說明按鈕控制所支援的屬性,讓您能更精確地控制驗證流程。

房產 說明
CausesValidation 指定點擊按鈕是否同時執行驗證檢查。 將此屬性設為 以防止 false 驗證檢查。
ValidationGroup 讓你能指定點擊按鈕時會呼叫頁面上的哪些驗證者。 若未建立驗證群組,按下按鈕即可呼叫頁面上所有驗證者。

欲了解更多資訊,請參閱「 ASP.NET 網頁中驗證使用者輸入」。

資料控制中的按鈕

按鈕網頁伺服器控制項常用於資料控制,例如在 DataListGridViewRepeater 列表控制項中。 在這些情況下,你通常不會直接回應按鈕點擊事件。 取而代之的是,資料控制中的按鈕會觸發與該資料控制專屬的事件。 例如,在控制鍵 DataList 中,某個按鈕可能會提升 DataList 控制 ItemCommand 鍵的事件,而不是提升 Button 控制 Click 鍵的事件。

由於資料綁定的清單控制項可能包含許多按鈕,你可以設定 CommandArgument 按鈕的屬性指定一個要傳遞的值作為事件的一部分。 你可以測試這個論點,看看是哪個按鈕被點擊。

將資料綁定到控制器

你可以將按鈕的網頁伺服器控制項綁定到資料來源,以動態控制它們的屬性設定。 例如,你可以透過資料綁定來設定按鈕的 Text 屬性。

使用按鈕搭配 UpdatePanel 控制項

部分頁面渲染使得頁面部分內容能夠在不需回貼的情況下刷新。 UpdatePanel 控制項允許你標記參與部分頁面渲染的頁面區域。 預設情況下,控制項內部 UpdatePanel 的控制項(包括 Button 控制項)的行為是執行非同步回傳,而非回傳。 這只會刷新回傳來源控制項的內容 UpdatePanel

除了控制項在控制UpdatePanel項內的情境Button外,你還可以在以下情境中使用Button控制項: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"
/>

建構函式

名稱 Description
Button()

初始化 Button 類別的新執行個體。

屬性

名稱 Description
AccessKey

取得或設定存取金鑰,讓你能快速導航到網頁伺服器控制。

(繼承來源 WebControl)
Adapter

拿到瀏覽器專用的控制器轉接器。

(繼承來源 Control)
AppRelativeTemplateSourceDirectory

取得或設定包含此控制項的 or UserControl 物件的Page應用程式相對虛擬目錄。

(繼承來源 Control)
Attributes

取得一組任意屬性(僅用於渲染),這些屬性與控制項上的屬性不對應。

(繼承來源 WebControl)
BackColor

取得或設定網頁伺服器控制項的背景色。

(繼承來源 WebControl)
BindingContainer

取得包含該控制項資料綁定的控制項。

(繼承來源 Control)
BorderColor

取得或設定網頁控制的邊框顏色。

(繼承來源 WebControl)
BorderStyle

取得或設定網頁伺服器控制的邊界樣式。

(繼承來源 WebControl)
BorderWidth

取得或設定網頁伺服器控制的邊界寬度。

(繼承來源 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 與伺服器控制項相關聯的物件,用於目前的網頁請求。

(繼承來源 Control)
Controls

取得 ControlCollection 一個物件,代表 UI 階層中指定伺服器控制項的子控制項。

(繼承來源 Control)
ControlStyle

這就有網頁伺服器控制的風格。 此特性主要由對照顯影劑使用。

(繼承來源 WebControl)
ControlStyleCreated

會取得一個值,表示該屬性是否 Style 已建立 ControlStyle 物件。 此特性主要由控制顯影劑使用。

(繼承來源 WebControl)
CssClass

取得或設定由網頁伺服器控制項在用戶端渲染的層疊樣式表(CSS)類別。

(繼承來源 WebControl)
DataItemContainer

如果命名容器實 IDataItemContainer作 。

(繼承來源 Control)
DataKeysContainer

如果命名容器實 IDataKeysControl作 。

(繼承來源 Control)
DesignMode

會獲得一個值,表示是否在設計表面上使用控制項。

(繼承來源 Control)
Enabled

取得或設定一個值,表示網頁伺服器控制是否已啟用。

(繼承來源 WebControl)
EnableTheming

取得或設定一個值,指示主題是否適用於此控制。

(繼承來源 WebControl)
EnableViewState

取得或設定一個值,指示伺服器控制項是否能持久化其視圖狀態,以及其包含的任何子控制項的視圖狀態,給請求端客戶端。

(繼承來源 Control)
Events

會取得一個事件處理代理清單來管理控制。 這個屬性是唯讀的。

(繼承來源 Control)
Font

取得與網頁伺服器控制項相關的字型屬性。

(繼承來源 WebControl)
ForeColor

取得或設定網頁伺服器控制項的前景顏色(通常是文字顏色)。

(繼承來源 WebControl)
HasAttributes

會得到一個值,表示控制項是否設定了屬性。

(繼承來源 WebControl)
HasChildViewState

會取得一個值,表示目前伺服器控制項的子控制項是否儲存了任何檢視狀態設定。

(繼承來源 Control)
Height

取得或設定網頁伺服器控制的高度。

(繼承來源 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屬性為 false時,是否應該將渲染中的 HTML 元素的屬性設disabled為「disabled」 。

(繼承來源 WebControl)
TabIndex

取得或設定網頁伺服器控制的分頁索引。

(繼承來源 WebControl)
TagKey

取得 HtmlTextWriterTag 對應於此網頁伺服器控制的值。 此特性主要由對照顯影劑使用。

(繼承來源 WebControl)
TagName

取得控制標籤名稱。 此特性主要由對照顯影劑使用。

(繼承來源 WebControl)
TemplateControl

取得或設定包含此控制項的範本參考。

(繼承來源 Control)
TemplateSourceDirectory

取得包含當前伺服器控制權的 or UserControl 虛擬目錄Page

(繼承來源 Control)
Text

取得或設定控制面板中 Button 顯示的文字說明。

ToolTip

當滑鼠指標懸停在網頁伺服器控制項上時,會取得或設定顯示的文字。

(繼承來源 WebControl)
UniqueID

取得伺服器控制的唯一、階層限定的識別碼。

(繼承來源 Control)
UseSubmitBehavior

取得或設定一個值,指示控制項是 Button 使用用戶端瀏覽器的提交機制還是 ASP.NET 回傳機制。

ValidateRequestMode

取得或設定一個值,指示控制器是否檢查瀏覽器的客戶端輸入是否有潛在危險的值。

(繼承來源 Control)
ValidationGroup

取得或設定控制群組,該 Button 控制項在回傳伺服器時會觸發驗證。

ViewState

取得狀態資訊字典,讓你能儲存並還原伺服器控制的多個請求,針對同一頁面。

(繼承來源 Control)
ViewStateIgnoresCase

會得到一個值,表示該物件是否 StateBag 不區分大小寫。

(繼承來源 Control)
ViewStateMode

取得或設定此控制的視圖狀態模式。

(繼承來源 Control)
Visible

取得或設定一個值,指示伺服器控制項是否以 UI 形式呈現在頁面上。

(繼承來源 Control)
Width

取得或設定網頁伺服器控制的寬度。

(繼承來源 WebControl)

方法

名稱 Description
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()

將目前控制實例及任何子控制的屬性設定 ClientIDModeInherit

(繼承來源 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)

取得對應一組路由參數的網址。

(繼承來源 Control)
GetRouteUrl(RouteValueDictionary)

取得對應一組路由參數的網址。

(繼承來源 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)

在子控制從物件集合ControlControls移除後呼叫。

(繼承來源 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)

會取得瀏覽器可以使用的網址。

(繼承來源 Control)
ResolveUrl(String)

將一個網址轉換成請求客戶端可用的網址。

(繼承來源 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)

事件

名稱 Description
Click

當按下控制器時 Button 會發生。

Command

當按下控制器時 Button 會發生。

DataBinding

當伺服器控制項綁定到資料來源時會發生。

(繼承來源 Control)
Disposed

當伺服器控制從記憶體中釋放時發生,這是伺服器控制生命週期中請求 ASP.NET 頁面的最後階段。

(繼承來源 Control)
Init

發生在伺服器控制初始化時,這是其生命週期的第一步。

(繼承來源 Control)
Load

當伺服器控制項載入 Page 物件時會發生。

(繼承來源 Control)
PreRender

發生在物件載入後 Control 但渲染之前。

(繼承來源 Control)
Unload

當伺服器控制項從記憶體卸載時發生。

(繼承來源 Control)

明確介面實作

名稱 Description
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

擴充方法

名稱 Description
FindDataSourceControl(Control)

回傳與指定控制項相關聯的資料來源。

FindFieldTemplate(Control, String)

回傳指定控制項命名容器中指定欄位的欄位範本。

FindMetaTable(Control)

回傳包含資料控制項的元值物件。

適用於

另請參閱