WebControl.SupportsDisabledAttribute Özellik

  • Başvuru

Tanım

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

Denetimin özelliği falseolduğundaIsEnabled, denetimin 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 : bool
Public Overridable ReadOnly Property SupportsDisabledAttribute As Boolean

Özellik Değeri

Boolean

Her zaman true.

Öznitelikler
BrowsableAttribute

Örnekler

Aşağıdaki örnekte devre dışı bırakılmış Label bir denetim için işaretleme 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 falseayarlansa bile 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 isetrue, ASP.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 işler.

Türetilmiş sınıflar, aşağıdaki koşulların tümü doğruysa döndürülecek false şekilde bu özelliği geçersiz kılar:

  • Denetim, özniteliğini desteklemeyen disabled bir HTML öğesi işler.

  • özelliği, RenderingCompatibility 4.0'dan küçük bir ASP.NET sürüm numarası 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 düşü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 otomatik olarak önceki sürüm numarasına ayarlar controlRenderingCompatibilityVersion (özelliği ayarlar RenderingCompatibility ). 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ışı denetimler için HTML işlemesine neden olur. Yükseltilmiş bir Web sitesinin ASP.NET 4'te tanıtılan algoritmayı kullanarak HTML işlemesini controlRenderingCompatibilityVersion istiyorsanız, özniteliğini değiştirebilir veya kaldırabilirsiniz. Daha fazla bilgi için özelliğine RenderingCompatibility 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ğin 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.

Özelliğinde bir değer class varsa, bir denetim için işlenen HTML öğesinin özniteliğinde CssClass birden fazla değer olabilir. Daha fazla bilgi için özelliğine DisabledCssClass bakın.

Şunlara uygulanır

Ayrıca bkz.