WebControl.SupportsDisabledAttribute 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 nilai yang menunjukkan apakah kontrol harus mengatur disabled atribut elemen HTML yang dirender ke "dinonaktifkan" ketika properti kontrol IsEnabled adalah false.
public:
virtual property bool SupportsDisabledAttribute { bool get(); };[System.ComponentModel.Browsable(false)]
public virtual bool SupportsDisabledAttribute { get; }[<System.ComponentModel.Browsable(false)>]
member this.SupportsDisabledAttribute : boolPublic Overridable ReadOnly Property SupportsDisabledAttribute As BooleanNilai Properti
Selalu true.
- Atribut
Contoh
Contoh berikut menunjukkan markup untuk kontrol yang dinonaktifkan Label :
<asp:Label id="Label1" runat="server" Text="Test" Enabled="false"/>
Dalam ASP.NET 3.5 dan versi yang lebih lama, markup ini merender HTML berikut:
<span id="Label1" disabled="disabled">Test</span>
Di ASP.NET 4, jika nilai RenderingCompatibility properti adalah 4,0 atau lebih besar, dan jika DisabledCssClass properti diatur ke nilai defaultnya, markup yang sama merender HTML berikut:
<span id="Label1" class="aspNetDisabled">Test</span>
Keterangan
Dalam kelas turunan, properti ini menunjukkan bagaimana ASP.NET harus merender HTML untuk kontrol saat kontrol dinonaktifkan.
Menonaktifkan Kontrol Web ASP.NET
Enabled Ketika properti kontrol ASP.NET diatur ke false (yaitu, ketika kontrol dinonaktifkan), niatnya adalah bahwa ASP.NET harus merender kontrol di halaman, tetapi menampilkannya dalam keadaan dinonaktifkan (biasanya redup). Jika kontrol induk dinonaktifkan, turunan kontrol tersebut juga ditampilkan sebagai dinonaktifkan. Dalam hal ini, properti kontrol IsEnabled anak diatur ke false, meskipun propertinya Enabled mungkin diatur ke true.
Dalam ASP.NET 3.5 dan versi yang lebih lama, ketika properti kontrol IsEnabled adalah false, ASP.NET mengatur disabled atribut ke "dinonaktifkan" dalam elemen HTML yang dirender untuk kontrol. Namun, standar HTML 4.01 memungkinkan disabled atribut hanya pada elemen tertentu yang digunakan untuk input pengguna. Misalnya, disabled atribut diizinkan untuk input elemen, tetapi tidak untuk span elemen.
Sebagian besar browser mendukung tampilan default yang dinonaktifkan untuk elemen khusus tampilan yang memiliki disabled atribut. Namun, untuk mematuhi standar HTML, secara default ASP.NET 4 menghilangkan atribut yang tidak valid.
Cara Properti SupportsDisabledAttribute Digunakan
SupportsDisabledAttribute Jika properti adalah true, ASP.NET merender disabled atribut saat kontrol dinonaktifkan. Jika properti ini adalah false, ASP.NET merender class atribut saat kontrol dinonaktifkan.
Kelas turunan mengambil alih properti ini untuk mengembalikan false jika semua kondisi berikut ini benar:
Kontrol merender elemen HTML yang tidak mendukung
disabledatribut .Properti RenderingCompatibility menunjukkan nomor versi ASP.NET yang lebih rendah dari 4.0.
Properti SupportsDisabledAttribute tidak selalu menunjukkan apakah elemen HTML yang dirender untuk kontrol mendukung (memungkinkan) disabled atribut. Jika properti kontrol RenderingCompatibility menunjukkan nomor versi ASP.NET yang lebih rendah dari 4.0, nilai properti kontrol SupportsDisabledAttribute mungkin kembali true meskipun HTML yang dirender tidak mendukung disabled atribut .
Kompatibilitas Mundur untuk Kontrol Yang Dinonaktifkan
Saat Anda menggunakan Visual Studio untuk meningkatkan proyek Web ke ASP.NET 4 dari versi sebelumnya, Visual Studio secara otomatis mengatur controlRenderingCompatibilityVersion atribut dalam file Web.config (yang mengatur RenderingCompatibility properti) ke nomor versi sebelumnya.
SupportsDisabledAttribute Karena properti selalu kembali true ketika RenderingCompatibility properti lebih rendah dari 4.0, ini menyebabkan kontrol Web merender HTML untuk kontrol yang dinonaktifkan seperti yang mereka lakukan di versi sebelumnya. Jika Anda ingin situs Web yang dimutakhirkan merender HTML menggunakan algoritma yang diperkenalkan di ASP.NET 4, Anda dapat mengubah atau menghapus controlRenderingCompatibilityVersion atribut. Untuk informasi selengkapnya, lihat properti RenderingCompatibility.
Mengatur Tampilan yang Dinonaktifkan Dengan Menggunakan CSS
SupportsDisabledAttribute Jika properti kontrol adalah false dan kontrol dinonaktifkan, ASP.NET mengatur class atribut elemen HTML yang dirender ke nilai WebControl.DisabledCssClass properti . Nilai WebControl.DisabledCssClass default properti adalah "aspNetDisabled".
Untuk memberikan tampilan yang dinonaktifkan untuk kontrol yang dinonaktifkan, Anda harus menentukan aturan CSS untuk kelas yang diwakili oleh nilai WebControl.DisabledCssClass properti.
Elemen HTML yang dirender untuk kontrol mungkin memiliki lebih dari satu nilai dalam atributnya class jika ada nilai dalam propertinya CssClass . Untuk informasi selengkapnya, lihat properti DisabledCssClass.
