WebControl.Enabled Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé.
public:
virtual property bool Enabled { bool get(); void set(bool value); };[System.ComponentModel.Bindable(true)]
public virtual bool Enabled { get; set; }[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public virtual bool Enabled { get; set; }[<System.ComponentModel.Bindable(true)>]
member this.Enabled : bool with get, set[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
member this.Enabled : bool with get, setPublic Overridable Property Enabled As BooleanValeur de propriété
true si le contrôle est activé ; sinon, false. La valeur par défaut est true.
- Attributs
Exemples
L’exemple suivant montre comment activer et désactiver un TextBox contrôle, hérité de la WebControl classe de base, en définissant sa Enabled propriété par programmation.
Notes
L’exemple de code suivant utilise le modèle de code à fichier unique et peut ne pas fonctionner correctement s’il est copié directement dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide qui a une extension .aspx. Pour plus d’informations sur le modèle de code Web Forms, consultez ASP.NET Web Forms modèle de code de page.
Important
Cet exemple comprend une zone de texte qui accepte une entrée d'utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.
<%@ 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 SubmitBtn1_Click(object sender, EventArgs e)
{
TextBox1.Enabled = (!TextBox1.Enabled);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>Enabled Property Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Enabled Property of a Web Control</h3>
<p>
<asp:TextBox id="TextBox1" BackColor="LightBlue"
runat="server">Light Blue</asp:TextBox>
</p>
<p>
<asp:TextBox id="TextBox2" BackColor="LightGreen"
runat="server">Light Green</asp:TextBox>
</p>
<asp:Button id="SubmitBtn1" runat="server"
Text="Click to disable or enable the light blue text box"
OnClick="SubmitBtn1_Click" />
</div>
</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 SubmitBtn1_Click(ByVal sender As Object, ByVal e As EventArgs)
TextBox1.Enabled = Not (TextBox1.Enabled)
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>Enabled Property Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>Enabled Property of a Web Control</h3>
<p>
<asp:TextBox id="TextBox1" BackColor="LightBlue"
runat="server">Light Blue</asp:TextBox>
</p>
<p>
<asp:TextBox id="TextBox2" BackColor="LightGreen"
runat="server">Light Green</asp:TextBox>
</p>
<asp:Button id="SubmitBtn1" runat="server"
Text="Click to disable or enable the light blue text box"
OnClick="SubmitBtn1_Click" />
</div>
</form>
</body>
</html>
Remarques
Lorsque la Enabled propriété d’un contrôle est définie falsesur , le contrôle apparaît généralement grisé. Si le contrôle est un élément d’entrée, le navigateur empêche l’utilisateur de cliquer ou de taper dessus. Les éléments HTML qui sont rendus pour un contrôle serveur sont marqués comme désactivés en définissant leur disabled attribut ou leur attribut CSS class . Pour plus d’informations, consultez SupportsDisabledAttribute et ControlRenderingCompatibilityVersion.
Cette propriété propage la hiérarchie de contrôle. Si vous désactivez un contrôle de conteneur, les contrôles enfants au sein de ce conteneur sont également désactivés. Pour plus d'informations, consultez la propriété IsEnabled.
Notes
Dans un contrôle composite personnalisé, ce comportement d’héritage ne s’applique pas aux contrôles qui n’ont pas encore créé leurs contrôles enfants. Vous devez définir l’état activé des contrôles enfants lors de leur création, ou remplacer la Enabled propriété pour appeler la EnsureChildControls méthode.
Notes
La désactivation d’un contrôle empêche uniquement l’interaction avec le contrôle par l’utilisateur via l’interface utilisateur du navigateur. Il est possible qu’un utilisateur crée une demande qui envoie une publication différée traitée par la page, même si les contrôles de la page sont désactivés. Avant de traiter une demande de publication, vérifiez que le contrôle est activé et visible.
Tous les contrôles ne prennent pas en charge cette propriété. Pour plus d’informations, consultez les contrôles individuels.
Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET Thèmes et apparences.