WebControl.Enabled Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy formant serwera sieci Web jest włączony.Gets or sets a value indicating whether the Web server control is enabled.

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, set
Public Overridable Property Enabled As Boolean

Wartość właściwości

Boolean

trueJeśli kontrola jest włączona; w przeciwnym razie false .true if control is enabled; otherwise, false. Wartość domyślna to true.The default is true.

Atrybuty

Przykłady

Poniższy przykład ilustruje sposób włączania i wyłączania TextBox kontrolki dziedziczonej z WebControl klasy podstawowej przez ustawienie jej Enabled właściwości programowo.The following example illustrates how to enable and disable a TextBox control, inherited from the WebControl base class, by setting its Enabled property programmatically.

Uwaga

Poniższy przykład kodu używa modelu kodu jednoplikowego i może nie działa poprawnie, jeśli jest kopiowany bezpośrednio do pliku związanego z kodem.The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. Ten przykład kodu musi być skopiowany do pustego pliku tekstowego, który ma rozszerzenie. aspx.This code sample must be copied into an empty text file that has an .aspx extension. Aby uzyskać więcej informacji na temat modelu kodu formularzy sieci Web, zobacz ASP.NET Web Forms Code Model.For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

Ważne

Ten przykład zawiera pole tekstowe akceptujące dane wejściowe użytkownika, które jest potencjalnym zagrożeniem bezpieczeństwa.This example has a text box that accepts user input, which is a potential security threat. Domyślnie strony sieci Web ASP.NET sprawdzają, czy dane wejściowe użytkownika nie obejmują elementów skryptu ani HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach.For more information, see 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>
<%@ 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>

Uwagi

Gdy Enabled Właściwość kontrolki jest ustawiona na false , kontrolka zazwyczaj jest wyszarzona.When the Enabled property of a control is set to false, the control typically appears dimmed. Jeśli formant jest elementem wejściowym, przeglądarka uniemożliwia użytkownikowi kliknięcie lub wpisanie w nim.If the control is an input element, the browser prevents the user from clicking or typing in it. Elementy HTML renderowane dla formantu serwera są oznaczane jako wyłączone przez ustawienie ich disabled atrybutu lub ich class atrybutu CSS.HTML elements that are rendered for a server control are marked as disabled by setting their disabled attribute or their CSS class attribute. Aby uzyskać więcej informacji, zobacz SupportsDisabledAttribute i ControlRenderingCompatibilityVersion.For more information, see SupportsDisabledAttribute and ControlRenderingCompatibilityVersion.

Ta właściwość propaguje hierarchię formantów.This property propagates down the control hierarchy. Wyłączenie formantu kontenera spowoduje również wyłączenie formantów podrzędnych znajdujących się w tym kontenerze.If you disable a container control, the child controls within that container are also disabled. Aby uzyskać więcej informacji, zobacz IsEnabled Właściwość.For more information, see the IsEnabled property.

Uwaga

W niestandardowym formancie złożonym to zachowanie dziedziczenia nie ma zastosowania do formantów, które nie utworzyły jeszcze formantów podrzędnych.In a custom composite control, this inheritance behavior does not apply to controls that have not yet created their child controls. Należy ustawić włączony stan formantów podrzędnych po ich utworzeniu lub zastąpić Enabled Właściwość w celu wywołania EnsureChildControls metody.You must either set the enabled state of the child controls when they are created, or override the Enabled property to call the EnsureChildControls method.

Uwaga

Wyłączenie formantu uniemożliwia interakcję z kontrolką użytkownika za pomocą interfejsu użytkownika przeglądarki.Disabling a control only prevents interaction with the control by the user through the browser UI. Użytkownik może połączyć żądanie, które przesyła ogłaszanie zwrotne przetwarzane przez stronę, nawet jeśli kontrolki na stronie są wyłączone.It is possible for a user to craft a request that submits a postback that is processed by the page even if controls on the page are disabled. Przed przetworzeniem żądania ogłaszania zwrotnego upewnij się, że formant jest włączony i widoczny.Before you process a postback request, check to make sure that the control is enabled and visible.

Nie wszystkie formanty obsługują tę właściwość.Not all controls support this property. Aby uzyskać szczegółowe informacje, zobacz poszczególne kontrolki.See the individual controls for details.

Tej właściwości nie można ustawić za pomocą motywów lub motywów arkuszy stylów.This property cannot be set by themes or style sheet themes. Aby uzyskać więcej informacji, zobacz temat ThemeableAttribute i ASP.NET motywy i karnacje.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Dotyczy

Zobacz też