Freigeben über

ImageButton.Enabled Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob auf den ImageButton Server geklickt werden kann, um einen Beitrag zurück auf den Server auszuführen.

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

Eigenschaftswert

Boolean

truewenn das Steuerelement aktiviert ist; andernfalls . false Der Standardwert lautet true.

Attribute
BindableAttribute BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Enabled Eigenschaft veranschaulicht. Die Seite enthält zwei ImageButton Steuerelemente. Die Enabled Eigenschaft ist für die EnabledImageButton Bildschaltfläche festgelegttrue, sodass sie beim Klicken wieder auf den Server zurückgesendet wird. Die Enabled Eigenschaft ist für die NotEnabledImageButton Bildschaltfläche festgelegtfalse, wodurch sie auf der Seite gerendert wird, aber nicht auf den Server zurückgesendet wird, wenn auf sie geklickt wird.

Hinweis

Im folgenden Codebeispiel wird das Codemodell mit einer Datei verwendet und funktioniert möglicherweise nicht ordnungsgemäß, wenn es direkt in eine CodeBehind-Datei kopiert wird. Dieses Codebeispiel muss in eine leere Textdatei kopiert werden, die über eine .aspx Erweiterung verfügt. Weitere Informationen zum Web Forms-Codemodell finden Sie unter 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>

Hinweise

Verwenden Sie die Enabled Eigenschaft, um anzugeben, ob auf einen ImageButton Beitrag zurück auf den Server geklickt werden kann. Wenn Sie diese Eigenschaft auf false festlegen, wird das Steuerelement auf der Seite gerendert, löst aber kein Postback-Ereignis aus, wenn darauf geklickt wird.

Gilt für:

Weitere Informationen