WebControl.SupportsDisabledAttribute Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

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á označuje, zda ovládací prvek má nastavit disabled atribut vykresleného HTML elementu na "disabled" když je falsevlastnost ovládacího prvku IsEnabled .

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

Hodnota vlastnosti

Boolean

Vždy hodnota true.

Atributy: BrowsableAttribute

Příklady

Následující příklad ukazuje revize zakázaného Label ovládacího prvku:

<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 vykreslí 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 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 když je ovládací prvek zakázaný), záměr je, že ASP.NET by měl ovládací prvek vykreslit na stránce, ale zobrazit ho v zakázaném stavu (obvykle neaktivní). Pokud je nadřazený ovládací prvek zakázaný, podřízené položky tohoto ovládacího prvku se zobrazí také 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ý se vykreslí 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 elementy.

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.

Jak se používá vlastnost SupportsDisabledAttribute

SupportsDisabledAttribute Pokud je truevlastnost , ASP.NET vykreslí 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řepíší tuto vlastnost, aby se vrátila, false pokud jsou splněny všechny následující podmínky:

Ovládací prvek vykreslí element HTML, který nepodporuje disabled atribut.
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 (povoluje) 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 v případě, že vykreslený kód HTML atribut nepodporujedisabled.

Zpětná kompatibilita pro zakázané ovládací prvky

Pokud použijete Visual Studio k upgradu webového projektu na ASP.NET 4 ze starší verze, Visual Studio automaticky nastaví controlRenderingCompatibilityVersion atribut v souboru Web.config (který nastaví RenderingCompatibility vlastnost) na dřívější číslo verze. Vzhledem k tomu, že SupportsDisabledAttribute vlastnost je 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, jako tomu bylo 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 odebratcontrolRenderingCompatibilityVersion. Další informace najdete v RenderingCompatibility této vlastnosti.

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 v jeho CssClass vlastnosti. Další informace najdete v DisabledCssClass této vlastnosti.

Platí pro