共用方式為

ImageButton.Enabled 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定值，指出是否可以在按下 ImageButton 後，執行回傳至伺服器的作業。

public:
 virtual property bool Enabled { bool get(); void set(bool value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Browsable(true)]
public override bool Enabled { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.Browsable(true)>]
member this.Enabled : bool with get, set
Public Overrides Property Enabled As Boolean

屬性值

Boolean

如果已啟用控制項，則為 true，否則為 false。 預設為 true。

屬性
BindableAttribute BrowsableAttribute

範例

下列程式代碼範例示範如何使用 Enabled 屬性。 頁面包含兩個 ImageButton 控制件。 影像按鈕的 Enabled 屬性會設定 true 為 EnabledImageButton ，使其在單擊時回傳至伺服器。 屬性Enabled會針對NotEnabledImageButton影像按鈕設定為 false ，使其在頁面上呈現，但在按兩下時不會回傳至伺服器。

注意

下列程式代碼範例會使用單一檔案程式代碼模型，如果直接複製到程式代碼後置檔案，可能無法正常運作。 此程式代碼範例必須複製到具有.aspx擴展名的空白文本檔。 如需 Web Forms 程式代碼模型的詳細資訊，請參閱 ASP.NET Web Forms 頁面代碼模型。

<%@ page language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void EnabledButton_Click (object sender, ImageClickEventArgs e)
  {
    Label1.Text = "You selected the enabled button.";
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageButton.Enabled Example</title>
</head>
<body>
  <form id="form1" runat="server">
    
    <h3>ImageButton.Enabled Example</h3>
    
    <asp:imagebutton id="EnabledImageButton"
      enabled="true"
      alternatetext="Enabled Button"
      imageurl="Images\EnabledButton.jpg"
      onclick="EnabledButton_Click"
      runat="Server">
    </asp:imagebutton>
    
    <br /><br /><br />    
    
    <asp:imagebutton id="NotEnabledImageButton"
      enabled="false"
      alternatetext="Not Enabled Button"
      imageurl="Images\NotEnabledButton.jpg"
      runat="Server">
    </asp:imagebutton> 
    
    <br /><br />
    
    <asp:label id="Label1"
      runat="Server">
    </asp:label>
 
  </form>
</body>
</html>

<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  Sub EnabledButton_Click(ByVal sender As Object, ByVal e As ImageClickEventArgs)
    
    Label1.Text = "You selected the enabled button."
        
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageButton.Enabled Example</title>
</head>
<body>
  <form id="form1" runat="server">
    
    <h3>ImageButton.Enabled Example</h3>
    
    <asp:imagebutton id="EnabledImageButton"
      enabled="true"
      alternatetext="Enabled Button"
      imageurl="Images\EnabledButton.jpg"
      onclick="EnabledButton_Click"
      runat="Server">
    </asp:imagebutton>
    
    <br /><br /><br />    
    
    <asp:imagebutton id="NotEnabledImageButton"
      enabled="false"
      alternatetext="Not Enabled Button"
      imageurl="Images\NotEnabledButton.jpg"
      runat="Server">
    </asp:imagebutton> 
    
    <br /><br />
    
    <asp:label id="Label1"
      runat="Server">
    </asp:label>
 
  </form>
</body>
</html>

備註

Enabled使用屬性來指定 是否可以ImageButton按下 來執行回傳至伺服器。 如果您將此屬性設定為 false，控件會在頁面上呈現，但在按兩下時不會引發回傳事件。

適用於

另請參閱