WebControl.Enabled Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Web sunucusu denetiminin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.

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

Özellik Değeri

Boolean

true denetim etkinse; aksi takdirde , false. Varsayılan değer: true.

Öznitelikler
BindableAttribute ThemeableAttribute

Örnekler

Aşağıdaki örnek, özelliğini program aracılığıyla ayarlayarak Enabled temel sınıftan devralınan WebControl bir TextBox denetimin nasıl etkinleştirilip devre dışı bırakılacağını gösterir.

Not

Aşağıdaki kod örneği tek dosyalı kod modelini kullanır ve doğrudan arka planda kod dosyasına kopyalandığında düzgün çalışmayabilir. Bu kod örneği.aspx uzantısına sahip boş bir metin dosyasına kopyalanmalıdır. Web Forms kod modeli hakkında daha fazla bilgi için bkz. ASP.NET Web Forms Sayfa Kodu Modeli.

Önemli

Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz . Betik Açıklarına Genel Bakış.

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

Açıklamalar

Bir denetimin Enabled özelliği olarak falseayarlandığında, denetim genellikle soluk görünür. Denetim bir giriş öğesiyse, tarayıcı kullanıcının buna tıklamasını veya yazmasını engeller. Bir sunucu denetimi için işlenen HTML öğeleri, öznitelikleri veya CSS class öznitelikleri disabled ayarlanarak devre dışı olarak işaretlenir. Daha fazla bilgi için SupportsDisabledAttribute ve ControlRenderingCompatibilityVersion bölümlerine bakın.

Bu özellik denetim hiyerarşisini aşağı yayılım. Bir kapsayıcı denetimini devre dışı bırakırsanız, bu kapsayıcı içindeki alt denetimler de devre dışı bırakılır. Daha fazla bilgi için özelliğine IsEnabled bakın.

Not

Özel bileşik denetimde, bu devralma davranışı henüz alt denetimlerini oluşturmamış denetimler için geçerli değildir. Alt denetimlerin oluşturulduğunda etkin durumunu ayarlamanız veya yöntemini çağırmak EnsureChildControls için özelliğini geçersiz kılmanız Enabled gerekir.

Not

Denetimin devre dışı bırakılması, yalnızca tarayıcı kullanıcı arabirimi aracılığıyla kullanıcı tarafından denetimle etkileşimi engeller. Bir kullanıcının, sayfadaki denetimler devre dışı bırakıldığında bile sayfa tarafından işlenen bir geri gönderme gönderen bir istek oluşturması mümkündür. Geri gönderme isteğini işlemeden önce denetimin etkinleştirildiğinden ve görünür olduğundan emin olun.

Tüm denetimler bu özelliği desteklemez. Ayrıntılar için tek tek denetimlere bakın.

Bu özellik temalar veya stil sayfası temaları tarafından ayarlanamaz. Daha fazla bilgi için bkz ThemeableAttribute . temalar ve dış görünümler ASP.NET.

Şunlara uygulanır

Ayrıca bkz.