Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

WebControl.Enabled propriété

 

Date de publication : août 2016

Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé.

Espace de noms:   System.Web.UI.WebControls
Assembly:  System.Web (dans System.Web.dll)

[BindableAttribute(true)]
[ThemeableAttribute(false)]
public virtual bool Enabled { get; set; }

Valeur de propriété

Type: System.Boolean

true Si le contrôle est activé ; dans le cas contraire, false. La valeur par défaut est true.

Lors de la Enabled d'un contrôle est définie sur false, le contrôle apparaît généralement estompé. Si le contrôle est un élément d'entrée, le navigateur empêche l'utilisateur de cliquer dessus ou en tapant qu'il contient. Les éléments HTML restitués pour un contrôle serveur sont marqués comme désactivés en définissant leur disabled attribut ou leur CSS class attribut. Pour plus d’informations, consultez SupportsDisabledAttribute et ControlRenderingCompatibilityVersion.

Cette propriété se propage vers le bas de la hiérarchie des contrôles. Si vous désactivez un contrôle conteneur, les contrôles enfants dans ce conteneur sont également désactivés. Pour plus d'informations, consultez la propriété IsEnabled.

System_CAPS_noteRemarque

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é de l'enfant contrôles lorsqu'ils sont créés ou substituent le Enabled propriété à appeler le EnsureChildControls (méthode).

System_CAPS_noteRemarque

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 pour un utilisateur de créer une demande qui envoie une publication traitée par la page même si les contrôles sur la page sont désactivées. Avant de traiter une demande de publication, vérifiez que le contrôle est activé et visible.

Pas de tous les contrôles prennent en charge cette propriété. Consultez les contrôles pour plus d'informations.

Cette propriété ne peut pas être définie par les thèmes ou thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET Themes and Skins.

L'exemple suivant montre comment activer et désactiver un TextBox contrôle, héritée de la WebControl classe de base en définissant son Enabled propriété par programmation.

System_CAPS_noteRemarque

L'exemple de code suivant utilise le modèle de code de fichier unique et peut ne pas fonctionne correctement si copiées 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 Page Code Model.

System_CAPS_security Sécurité Remarque

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 Script Exploits Overview.

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

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: