HtmlControl.Disabled Propriedade

Referência

Definição

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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.

ASP.NET (C#)

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

Produto	Versões
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também

HtmlInputButton

Partilhar via