HtmlControl.Disabled Propriedade

  • Referência

Definição

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

Obtém ou define um valor que indica se o controle do servidor HTML está desabilitado.

public:
 property bool Disabled { bool get(); void set(bool value); };
public bool Disabled { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.MinimizableAttributeTypeConverter))]
public bool Disabled { get; set; }
member this.Disabled : bool with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.MinimizableAttributeTypeConverter))>]
member this.Disabled : bool with get, set
Public Property Disabled As Boolean

Valor da propriedade

Boolean

true se o controle estiver desabilitado; caso contrário, false. O valor padrão é false.

Atributos
TypeConverterAttribute

Exemplos

O exemplo de código a seguir demonstra como usar a Disabled propriedade para habilitar e desabilitar programaticamente um HtmlInputButton controle.

<%@ 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>HtmlControl Disabled Property Example</title>
<script language="C#" runat="server">
 
      void Submit_Clicked(Object sender, EventArgs e) 
      {
         
         Message.InnerHtml = "You clicked the submit button.";
 
      }        
      
 
      void Enable_Clicked(Object sender, EventArgs e) 
      {

         Message.InnerHtml = "";
         Submit2.Disabled=!Submit2.Disabled;

      }
 
   </script>
</head>
 
<body>
   <form id="form1" method="post" runat="server">

      <h3>HtmlControl Disabled Property Example</h3>

      <input id="Submit1"        
             type="submit"
             value="Enable/Disable Submit Button"
             onserverclick="Enable_Clicked"
             runat="server"/>

      <br /><br />

      <input id="Submit2"        
             type="submit"
             value="Submit"
             onserverclick="Submit_Clicked"
             runat="server"/>
      
      

      <br /><br />

      <span 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>HtmlControl Disabled Property Example</title>
<script language="VB" runat="server">
    Sub Submit_Clicked(sender As Object, e As EventArgs)
        
        Message.InnerHtml = "You clicked the submit button."
    End Sub 'Submit_Clicked
     
    Sub Enable_Clicked(sender As Object, e As EventArgs)
        
        Message.InnerHtml = ""
        Submit2.Disabled = Not Submit2.Disabled
    End Sub 'Enable_Clicked 
  </script>
</head>
 
<body>
   <form id="form1" method="post" runat="server">

      <h3>HtmlControl Disabled Property Example</h3>

      <input id="Submit1"        
             type="submit"
             value="Enable/Disable Submit Button"
             onserverclick="Enable_Clicked"
             runat="server"/>

      <br /><br />

      <input id="Submit2"        
             type="submit"
             value="Submit"
             onserverclick="Submit_Clicked"
             runat="server"/>
      
      

      <br /><br />

      <span id="Message" runat="server"/>  
 
   </form>

</body>
</html>

Comentários

No navegador, um elemento ou controle desabilitado é somente leitura, com as seguintes restrições adicionadas: seu valor não é enviado com o formulário, o elemento ou controle não pode receber o foco e o elemento ou controle é ignorado ao navegar pelo documento por meio de tabbing.

Aplica-se a

Confira também