WebControl.SupportsDisabledAttribute Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Denetimin özelliği falseolduğunda IsEnabled işlenen HTML öğesinin özniteliğini "devre dışı" olarak ayarlayıp ayarlamayacağını disabled belirten bir değer alır.
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 BooleanÖzellik Değeri
Her zaman true.
- Öznitelikler
Örnekler
Aşağıdaki örnekte devre dışı bırakılmış Label bir denetimin işaretlemesi gösterilmektedir:
<asp:Label id="Label1" runat="server" Text="Test" Enabled="false"/>
ASP.NET 3.5 ve önceki sürümlerde, bu işaretleme aşağıdaki HTML'yi işler:
<span id="Label1" disabled="disabled">Test</span>
ASP.NET 4'te, özelliğin RenderingCompatibility değeri 4,0 veya daha büyükse ve özellik varsayılan değerine ayarlanırsa DisabledCssClass , aynı işaretleme aşağıdaki HTML'yi işler:
<span id="Label1" class="aspNetDisabled">Test</span>
Açıklamalar
Türetilmiş sınıflarda bu özellik, denetim devre dışı bırakıldığında ASP.NET bir denetim için HTML'yi nasıl işlemesi gerektiğini gösterir.
ASP.NET Web Denetimlerini Devre Dışı Bırakma
Enabled bir ASP.NET denetiminin özelliği olarak false ayarlandığında (yani, denetim devre dışı bırakıldığında), amaç ASP.NET denetimi sayfada işlemesi, ancak devre dışı durumda (genellikle soluk) görüntülemesi gerektiğidir. Üst denetim devre dışı bırakılırsa, bu denetimin alt öğeleri de devre dışı olarak görüntülenir. Bu durumda, özelliği olarak ayarlansa falsebile alt denetimin IsEnabledEnabled özelliği olarak trueayarlanır.
ASP.NET 3.5 ve önceki sürümlerde, bir denetimin IsEnabled özelliği olduğunda falseASP.NET özniteliği, denetim için işlenen HTML öğesinde "devre dışı" olarak ayarlar disabled . Ancak, HTML 4.01 standardı özniteliğine disabled yalnızca kullanıcı girişi için kullanılan belirli öğelerde izin verir. Örneğin, disabled öznitelik öğeler için input izin verilir, ancak öğeler için span izin verilmez.
Çoğu tarayıcı, öznitelikleri olan disabled yalnızca görüntüleme öğeleri için varsayılan devre dışı görünümü destekler. Ancak, HTML standartlarına uymak için varsayılan olarak ASP.NET 4 geçersiz öznitelikleri atlar.
SupportsDisabledAttribute Özelliği Nasıl Kullanılır?
SupportsDisabledAttribute özelliği ise trueASP.NET denetim devre dışı bırakıldığında bir disabled öznitelik oluşturur. Bu özellik ise false, ASP.NET denetim devre dışı bırakıldığında bir class öznitelik oluşturur.
Türetilmiş sınıflar, aşağıdaki koşulların tümü doğruysa bu özelliği döndürecek false şekilde geçersiz kılar:
Denetim özniteliğini desteklemeyen
disabledbir HTML öğesi işler.özelliği, RenderingCompatibility 4.0'dan küçük bir ASP.NET sürüm numarasını gösterir.
SupportsDisabledAttribute özelliği, bir denetim için işlenen HTML öğesinin özniteliği destekleyip desteklemediğini (izin verip vermediğini) disabled belirtmez. Denetimin RenderingCompatibility özelliği 4.0'dan küçük bir ASP.NET sürüm numarası gösteriyorsa, işlenen HTML özniteliği desteklemese bile denetimin SupportsDisabledAttribute özelliğinin disabled değeri döndürülebilirtrue.
Devre Dışı Denetimler için Geriye Dönük Uyumluluk
Bir Web projesini önceki bir sürümden ASP.NET 4'e yükseltmek için Visual Studio kullandığınızda, Visual Studio Web.config dosyasındaki özniteliği (özelliği ayarlar) otomatik olarak önceki sürüm numarasına ayarlar controlRenderingCompatibilityVersionRenderingCompatibility .
SupportsDisabledAttribute Özellik her zaman özellik 4.0'dan düşük olduğunda RenderingCompatibility döndürdüğündentrue, bu durum Web denetimlerinin önceki sürümde olduğu gibi devre dışı bırakılmış denetimler için HTML işlemesine neden olur. Yükseltilmiş bir Web sitesinin ASP.NET 4'te sunulan algoritmayı kullanarak HTML'yi işlemesini controlRenderingCompatibilityVersion istiyorsanız özniteliğini değiştirebilir veya kaldırabilirsiniz. Daha fazla bilgi için RenderingCompatibility özelliğine bakın.
CSS Kullanarak Devre Dışı Görünüm Ayarlama
Denetimin SupportsDisabledAttribute özelliği ise false ve denetim devre dışıysa, ASP.NET işlenen HTML öğesinin özniteliğini özelliğinin WebControl.DisabledCssClass değerine ayarlarclass. özelliğinin WebControl.DisabledCssClass varsayılan değeri "aspNetDisabled" değeridir.
Devre dışı denetimler için devre dışı bırakılmış bir görünüm sağlamak için, özelliğin değeriyle WebControl.DisabledCssClass temsil edilen sınıf için bir CSS kuralı tanımlamanız gerekir.
Bir denetim için işlenen HTML öğesinin özelliğinde class bir değer varsa özniteliğinde CssClass birden fazla değer olabilir. Daha fazla bilgi için DisabledCssClass özelliğine bakın.
