Bagikan melalui

WebControl.Enabled Properti

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server Web diaktifkan.

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

Nilai Properti

Boolean

true jika kontrol diaktifkan; jika tidak, false. Default adalah true.

Atribut
BindableAttribute ThemeableAttribute

Contoh

Contoh berikut menggambarkan cara mengaktifkan dan menonaktifkan TextBox kontrol, diwarisi dari WebControl kelas dasar, dengan mengatur propertinya Enabled secara terprogram.

Catatan

Sampel kode berikut menggunakan model kode file tunggal dan mungkin tidak berfungsi dengan benar jika disalin langsung ke file code-behind. Sampel kode ini harus disalin ke dalam file teks kosong yang memiliki ekstensi .aspx. Untuk informasi selengkapnya tentang model kode Formulir Web, lihat Model Kode Halaman Formulir Web ASP.NET.

Penting

Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.

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

Keterangan

Enabled Ketika properti kontrol diatur ke false, kontrol biasanya tampak redup. Jika kontrol adalah elemen input, browser mencegah pengguna mengklik atau mengetik di dalamnya. Elemen HTML yang dirender untuk kontrol server ditandai sebagai dinonaktifkan dengan mengatur atributnya disabled atau atribut CSS-nya class . Untuk informasi lebih lanjut, lihat SupportsDisabledAttribute dan ControlRenderingCompatibilityVersion.

Properti ini menyebar ke hierarki kontrol. Jika Anda menonaktifkan kontrol kontainer, kontrol anak dalam kontainer tersebut juga dinonaktifkan. Untuk informasi selengkapnya, lihat IsEnabled properti.

Catatan

Dalam kontrol komposit kustom, perilaku pewarisan ini tidak berlaku untuk kontrol yang belum membuat kontrol anak mereka. Anda harus mengatur status kontrol anak yang diaktifkan saat dibuat, atau mengambil alih Enabled properti untuk memanggil EnsureChildControls metode .

Catatan

Menonaktifkan kontrol hanya mencegah interaksi dengan kontrol oleh pengguna melalui UI browser. Dimungkinkan bagi pengguna untuk membuat permintaan yang mengirimkan postback yang diproses oleh halaman bahkan jika kontrol di halaman dinonaktifkan. Sebelum Anda memproses permintaan postback, periksa untuk memastikan bahwa kontrol diaktifkan dan terlihat.

Tidak semua kontrol mendukung properti ini. Lihat kontrol individual untuk detailnya.

Properti ini tidak dapat diatur oleh tema atau tema lembar gaya. Untuk informasi selengkapnya, lihat ThemeableAttribute dan ASP.NET Tema dan Kulit.

Berlaku untuk

Lihat juga