Share via

ImageButton.Enabled Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta un valore che indica se è possibile fare clic sul controllo ImageButton per eseguire un postback al 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; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.Browsable(true)>]
member this.Enabled : bool with get, set
Public Overrides Property Enabled As Boolean

Valore della proprietà

Boolean

true se il controllo è abilitato; in caso contrario false. Il valore predefinito è true.

Attributi
BindableAttribute BrowsableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come usare la Enabled proprietà. La pagina contiene due ImageButton controlli. La Enabled proprietà è impostata su true per il EnabledImageButton pulsante immagine, causando il postback al server quando si fa clic su . La Enabled proprietà è impostata su false per il NotEnabledImageButton pulsante immagine, causando il rendering nella pagina, ma non postback al server quando si fa clic su .

Nota

L'esempio di codice seguente usa il modello di codice a file singolo e potrebbe non funzionare correttamente se copiato direttamente in un file code-behind. Questo esempio di codice deve essere copiato in un file di testo vuoto con estensione aspx. Per altre informazioni sul modello di codice Web Forms, vedere Web Forms ASP.NET 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>

Commenti

Utilizzare la Enabled proprietà per specificare se è possibile fare clic su un ImageButton post per eseguire un postback al server. Se si imposta questa proprietà su false, il controllo esegue il rendering nella pagina, ma non genera un evento postback quando si fa clic su .

Si applica a

Vedi anche