ImageButton.Enabled ImageButton.Enabled ImageButton.Enabled ImageButton.Enabled Property

定義

ImageButton をクリックしてサーバーへのポストバックを実行できるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the ImageButton can be clicked to perform a post back to the server.

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; }
member this.Enabled : bool with get, set
Public Overrides Property Enabled As Boolean

プロパティ値

コントロールが有効な場合は true。それ以外の場合は falsetrue if the control is enabled; otherwise, false. 既定値は、true です。The default is true.

次のコード例は、プロパティのEnabled使用方法を示しています。The following code example demonstrates how to use the Enabled property. このページにはImageButton 、2つのコントロールが含まれています。The page contains two ImageButton controls. [イメージ] ボタンのtrue Enabled EnabledImageButtonプロパティがに設定されており、クリックするとサーバーにポストバックされます。The Enabled property is set to true for the EnabledImageButton image button, causing it to post back to the server when clicked. [イメージ] ボタンのfalse プロパティがに設定されているため、ページ上にレンダリングされますが、クリックしてもサーバーにポストバックされません。Enabled NotEnabledImageButtonThe Enabled property is set to false for the NotEnabledImageButton image button, causing it to render on the page, but not post back to the server when clicked.

注意

次のコードサンプルでは、単一ファイルのコードモデルを使用して、分離コードファイルに直接コピーした場合、正しく機能しない可能性があります。The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. このコードサンプルは、.aspx 拡張子を持つ空のテキストファイルにコピーする必要があります。This code sample must be copied into an empty text file that has an .aspx extension. Web フォームコードモデルの詳細については、「 ASP.NET Web Forms Page Code model」を参照してください。For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

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

注釈

プロパティを使用して、をImageButtonクリックしてサーバーへのポストバックを実行できるかどうかを指定します。 EnabledUse the Enabled property to specify whether an ImageButton can be clicked to perform a post back to the server. このプロパティをにfalse設定すると、コントロールはページ上にレンダリングされますが、クリックしてもポストバックイベントは発生しません。If you set this property to false, the control renders on the page, but does not raise a post back event when clicked.

適用対象

こちらもご覧ください