WebControl.Enabled Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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, setPublic Overridable Property Enabled As BooleanNilai Properti
true jika kontrol diaktifkan; jika tidak, false. Default adalah true.
- Atribut
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.
