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ğ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 : 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 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
disabledbir 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.
