WebControl.Enabled Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera sieci Web jest włączona.

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

true jeśli kontrolka jest włączona; w przeciwnym razie , false. Wartość domyślna to true.

Atrybuty
BindableAttribute ThemeableAttribute

Przykłady

Poniższy przykład ilustruje sposób włączania i wyłączania kontrolki dziedziczonej TextBox z klasy bazowej WebControl przez ustawienie jej Enabled właściwości programowo.

Uwaga

Poniższy przykładowy kod używa modelu kodu pojedynczego pliku i może nie działać poprawnie, jeśli został skopiowany bezpośrednio do pliku za pomocą kodu. Ten przykładowy kod musi zostać skopiowany do pustego pliku tekstowego, który ma rozszerzenie aspx. Aby uzyskać więcej informacji na temat modelu kodu Web Forms, zobacz ASP.NET Web Forms Page Code Model (Model kodu strony).

Ważne

W tym przykładzie znajduje się pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web weryfikują, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach skryptów.

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

Enabled Gdy właściwość kontrolki jest ustawiona na false, kontrolka zwykle jest wygaszona. Jeśli kontrolka jest elementem wejściowym, przeglądarka uniemożliwia użytkownikowi kliknięcie lub wpisanie w nim. Elementy HTML renderowane dla kontrolki serwera są oznaczone jako wyłączone przez ustawienie disabled atrybutu lub atrybutu CSS class . Aby uzyskać więcej informacji, zobacz SupportsDisabledAttribute i ControlRenderingCompatibilityVersion.

Ta właściwość propaguje hierarchię kontrolek. Jeśli wyłączysz kontrolkę kontenera, kontrolki podrzędne w tym kontenerze również zostaną wyłączone. Aby uzyskać więcej informacji, zobacz IsEnabled właściwość .

Uwaga

W niestandardowej kontrolce złożonej to zachowanie dziedziczenia nie ma zastosowania do kontrolek, które nie utworzyły jeszcze kontrolek podrzędnych. Należy ustawić włączony stan kontrolek podrzędnych podczas ich tworzenia lub zastąpić Enabled właściwość w celu wywołania EnsureChildControls metody.

Uwaga

Wyłączenie kontrolki uniemożliwia tylko interakcję z kontrolką przez użytkownika za pośrednictwem interfejsu użytkownika przeglądarki. Użytkownik może utworzyć żądanie, które przesyła postback, które jest przetwarzane przez stronę, nawet jeśli kontrolki na stronie są wyłączone. Przed przetworzeniem żądania zwrotnego sprawdź, czy kontrolka jest włączona i widoczna.

Nie wszystkie kontrolki obsługują tę właściwość. Aby uzyskać szczegółowe informacje, zobacz poszczególne kontrolki.

Nie można ustawić tej właściwości według motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttribute i ASP.NET Motywy i skóry.

Dotyczy

Zobacz też