WebControl.SupportsDisabledAttribute Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera wartość wskazującą, czy kontrolka powinna ustawić disabled atrybut renderowanego elementu HTML na wartość "disabled", gdy właściwość kontrolki IsEnabled ma wartość false.

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

Wartość właściwości

Boolean

Zawsze wartość true.

Atrybuty
BrowsableAttribute

Przykłady

W poniższym przykładzie pokazano znaczniki dla wyłączonej Label kontrolki:

<asp:Label id="Label1" runat="server" Text="Test" Enabled="false"/>

W ASP.NET 3.5 i starszych wersjach ten znacznik renderuje następujący kod HTML:

<span id="Label1" disabled="disabled">Test</span>

W ASP.NET 4, jeśli wartość RenderingCompatibility właściwości to 4.0 lub nowsza, a jeśli DisabledCssClass właściwość jest ustawiona na wartość domyślną, ten sam znacznik renderuje następujący kod HTML:

<span id="Label1" class="aspNetDisabled">Test</span>

Uwagi

W klasach pochodnych ta właściwość wskazuje, jak ASP.NET renderować kod HTML dla kontrolki, gdy kontrolka jest wyłączona.

Wyłączanie kontrolek sieci Web ASP.NET

Enabled Gdy właściwość kontrolki ASP.NET jest ustawiona na false (czyli gdy kontrolka jest wyłączona), intencją jest to, że ASP.NET powinna renderować kontrolkę na stronie, ale wyświetlać ją w stanie wyłączonym (zazwyczaj wygaszone). Jeśli kontrolka nadrzędna jest wyłączona, elementy podrzędne tej kontrolki są również wyświetlane jako wyłączone. W takim przypadku właściwość kontrolki podrzędnej jest ustawiona IsEnabled na falsewartość , mimo że Enabled jej właściwość może być ustawiona na truewartość .

W ASP.NET 3.5 i starszych wersjach, gdy właściwość kontrolki IsEnabled to false, ASP.NET ustawia disabled atrybut na "disabled" w elemecie HTML renderowany dla kontrolki. Jednak standard HTML 4.01 zezwala na disabled atrybut tylko na niektórych elementach, które są używane do wprowadzania danych przez użytkownika. Na przykład disabled atrybut jest dozwolony dla input elementów, ale nie dla span elementów.

Większość przeglądarek obsługuje domyślny wyłączony wygląd elementów tylko do wyświetlania, które mają disabled atrybuty. Jednak w celu zachowania zgodności ze standardami HTML domyślnie ASP.NET 4 pomija nieprawidłowe atrybuty.

Jak jest używana właściwość SupportsDisabledAttribute

SupportsDisabledAttribute Jeśli właściwość ma truewartość , ASP.NET renderuje disabled atrybut, gdy kontrolka jest wyłączona. Jeśli ta właściwość to false, ASP.NET renderuje class atrybut, gdy kontrolka jest wyłączona.

Klasy pochodne zastępują tę właściwość, aby zwrócić false , jeśli spełnione są wszystkie następujące warunki:

  • Kontrolka renderuje element HTML, który nie obsługuje atrybutu disabled .

  • Właściwość RenderingCompatibility wskazuje numer wersji ASP.NET niższy niż 4.0.

Właściwość SupportsDisabledAttribute nie musi wskazywać, czy element HTML renderowany dla kontrolki obsługuje (zezwala) disabled atrybut. Jeśli właściwość kontrolki RenderingCompatibility wskazuje ASP.NET numer wersji niższy niż 4.0, wartość właściwości kontrolki SupportsDisabledAttribute może zwrócić true nawet wtedy, gdy renderowany kod HTML nie obsługuje atrybutu disabled .

Zgodność z poprzednimi wersjami dla kontrolek wyłączonych

W przypadku uaktualniania projektu internetowego do ASP.NET 4 z wcześniejszej wersji za pomocą programu Visual Studio program Visual Studio automatycznie ustawia controlRenderingCompatibilityVersion atrybut w pliku Web.config (który ustawia RenderingCompatibility właściwość) na wcześniejszy numer wersji. SupportsDisabledAttribute Ponieważ właściwość jest zawsze zwracanatrue, gdy RenderingCompatibility właściwość jest niższa niż 4.0, powoduje to renderowanie kodu HTML dla wyłączonych kontrolek w sposób, w jaki zostały wykonane we wcześniejszej wersji. Jeśli chcesz, aby uaktualniona witryna sieci Web renderować kod HTML przy użyciu algorytmu wprowadzonego w ASP.NET 4, możesz zmienić lub usunąć controlRenderingCompatibilityVersion atrybut. Aby uzyskać więcej informacji, zobacz RenderingCompatibility właściwość .

Ustawianie wyłączonego wyglądu przy użyciu arkuszy CSS

SupportsDisabledAttribute Jeśli właściwość kontrolki jest false i kontrolka jest wyłączona, ASP.NET ustawia class atrybut renderowanego elementu HTML na wartość WebControl.DisabledCssClass właściwości. Wartość domyślna WebControl.DisabledCssClass właściwości to "aspNetDisabled".

Aby zapewnić wyłączony wygląd wyłączonych kontrolek, należy zdefiniować regułę CSS dla klasy reprezentowanej przez wartość WebControl.DisabledCssClass właściwości.

Element HTML renderowany dla kontrolki może mieć więcej niż jedną wartość w swoim atrybucie, jeśli w jego classCssClass właściwości znajduje się wartość. Aby uzyskać więcej informacji, zobacz DisabledCssClass właściwość .

Dotyczy

Zobacz też