WebControl.SupportsDisabledAttribute Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá hodnotu, která určuje, zda ovládací prvek má nastavit disabled atribut vykresleného HTML elementu na "zakázáno" při vlastnosti ovládacího prvku IsEnabled je 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 BooleanHodnota vlastnosti
Vždy true.
- Atributy
Příklady
Následující příklad ukazuje revize pro zakázaný Label ovládací prvek:
<asp:Label id="Label1" runat="server" Text="Test" Enabled="false"/>
V ASP.NET 3.5 a starších verzích tento kód vykresluje následující kód HTML:
<span id="Label1" disabled="disabled">Test</span>
V ASP.NET 4, pokud je hodnota RenderingCompatibility vlastnosti 4,0 nebo vyšší a pokud DisabledCssClass je vlastnost nastavena na výchozí hodnotu, stejný kód vykresluje následující kód HTML:
<span id="Label1" class="aspNetDisabled">Test</span>
Poznámky
V odvozených třídách tato vlastnost označuje, jak ASP.NET má vykreslit HTML pro ovládací prvek, když je ovládací prvek zakázán.
Zakázání webových ovládacích prvků ASP.NET
Enabled Pokud je vlastnost ovládacího prvku ASP.NET nastavena na false (to znamená, že je ovládací prvek zakázán), záměr je, že ASP.NET by měl vykreslit ovládací prvek na stránce, ale zobrazit ho v zakázaném stavu (obvykle šedě). Pokud je nadřazený ovládací prvek zakázaný, zobrazí se také podřízené položky tohoto ovládacího prvku jako zakázané. V takovém případě je vlastnost podřízeného ovládacího prvku IsEnabled nastavena na false, i když jeho Enabled vlastnost může být nastavena na true.
V ASP.NET 3.5 a starších verzích, pokud je falsevlastnost ovládacího prvku IsEnabled , ASP.NET nastaví disabled atribut na "zakázáno" v elementu HTML, který vykresluje pro ovládací prvek. Standard HTML 4.01 však umožňuje disabled atribut pouze u určitých prvků, které se používají pro uživatelský vstup. Atribut je například disabled povolený pro input elementy, ale ne pro span prvky.
Většina prohlížečů podporuje výchozí zakázaný vzhled prvků jen pro zobrazení, které mají disabled atributy. Aby však bylo možné dodržovat standardy HTML, ve výchozím nastavení ASP.NET 4 vynechá neplatné atributy.
Způsob použití vlastnosti SupportsDisabledAttribute
SupportsDisabledAttribute Pokud je truevlastnost , ASP.NET vykreslit disabled atribut při zakázání ovládacího prvku. Pokud je falsetato vlastnost , ASP.NET vykresluje class atribut při zakázání ovládacího prvku.
Odvozené třídy přepsat tuto vlastnost vrátit false , pokud jsou splněny všechny následující podmínky:
Ovládací prvek vykresluje element HTML, který nepodporuje
disabledatribut.Vlastnost RenderingCompatibility označuje ASP.NET číslo verze nižší než 4.0.
Vlastnost SupportsDisabledAttribute nemusí nutně znamenat, zda HTML element, který je vykreslen pro ovládací prvek podporuje (umožňuje) disabled atribut. Pokud vlastnost ovládacího prvku RenderingCompatibility označuje ASP.NET číslo verze nižší než 4.0, hodnota vlastnosti ovládacího prvku SupportsDisabledAttribute může vrátit true , i když vykreslený kód HTML nepodporuje disabled atribut.
Zpětná kompatibilita pro zakázané ovládací prvky
Při použití sady Visual Studio k upgradu webového projektu na ASP.NET 4 ze starší verze sada Visual Studio automaticky nastaví controlRenderingCompatibilityVersion atribut v souboru Web.config (který nastaví RenderingCompatibility vlastnost) na číslo starší verze. Vzhledem k tomu, že SupportsDisabledAttribute vlastnost vždy vrátí true , když RenderingCompatibility je vlastnost nižší než 4.0, způsobí to, že webové ovládací prvky vykreslují HTML pro zakázané ovládací prvky, jak to udělaly v předchozí verzi. Pokud chcete, aby upgradovaný web vykresloval kód HTML pomocí algoritmu zavedeného v ASP.NET 4, můžete atribut změnit nebo odebrat controlRenderingCompatibilityVersion . Další informace najdete ve vlastnosti RenderingCompatibility.
Nastavení zakázaného vzhledu pomocí šablon stylů CSS
SupportsDisabledAttribute Pokud je vlastnost ovládacího prvku a ovládací prvek je false zakázán, ASP.NET nastaví class atribut vykresleného html elementu na hodnotu WebControl.DisabledCssClass vlastnosti. Výchozí hodnota WebControl.DisabledCssClass vlastnosti je aspNetDisabled.
Chcete-li poskytnout zakázaný vzhled pro zakázané ovládací prvky, musíte definovat pravidlo CSS pro třídu, která je reprezentována hodnotou WebControl.DisabledCssClass vlastnosti.
Element HTML, který je vykreslen pro ovládací prvek může mít více než jednu hodnotu v jeho class atributu, pokud je hodnota ve své CssClass vlastnosti. Další informace najdete ve vlastnosti DisabledCssClass.
