WebControl.SupportsDisabledAttribute Właściwość

Definicja

Pobiera wartość wskazującą, czy formant powinien ustawić disabled atrybut renderowanego elementu HTML na "Disabled", gdy właściwość kontrolki IsEnabled ma wartość false .Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is 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.Always true.

Atrybuty

Przykłady

Poniższy przykład pokazuje znaczniki dla wyłączonej Label kontrolki:The following example shows markup for a disabled Label control:

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

W ASP.NET 3,5 i wcześniejszych wersjach ten znacznik renderuje następujący kod HTML:In ASP.NET 3.5 and earlier versions, this markup renders the following HTML:

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

W ASP.NET 4, jeśli wartość RenderingCompatibility właściwości jest równa 4,0 lub większa, a jeśli DisabledCssClass Właściwość ma ustawioną wartość domyślną, ta sama Adiustacja renderuje następujący kod HTML:In ASP.NET 4, if the value of the RenderingCompatibility property is 4.0 or greater, and if the DisabledCssClass property is set to its default value, the same markup renders the following HTML:

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

Uwagi

W klasach pochodnych ta właściwość wskazuje, w jaki sposób ASP.NET powinien renderować HTML dla kontrolki, gdy kontrolka jest wyłączona.In derived classes, this property indicates how ASP.NET should render HTML for a control when the control is disabled.

Wyłączanie kontrolek sieci Web ASP.NETDisabling ASP.NET Web Controls

Gdy Enabled właściwość formantu ASP.NET jest ustawiona na false (to oznacza, że gdy kontrolka jest wyłączona), zamiarem jest to, że ASP.NET powinna renderować kontrolkę na stronie, ale wyświetlać ją w stanie wyłączonym (zazwyczaj wyszarzony).When the Enabled property of an ASP.NET control is set to false (that is, when the control is disabled), the intent is that ASP.NET should render the control in the page, but display it in a disabled state (typically dimmed). Jeśli formant nadrzędny jest wyłączony, elementy podrzędne tego formantu są również wyświetlane jako wyłączone.If a parent control is disabled, children of that control are also displayed as disabled. W takim przypadku właściwość kontrolki podrzędnej IsEnabled jest ustawiona na false , nawet jeśli jej Enabled Właściwość może być ustawiona na true .In that case, the child control's IsEnabled property is set to false, even though its Enabled property might be set to true.

W ASP.NET 3,5 i starszych wersjach, gdy właściwość kontrolki IsEnabled ma wartość false , ASP.NET ustawia disabled atrybut na "Disabled" w elemencie HTML, który jest renderowany dla formantu.In ASP.NET 3.5 and earlier versions, when a control's IsEnabled property is false, ASP.NET sets the disabled attribute to "disabled" in the HTML element that it renders for the control. Jednak Standard HTML 4,01 zezwala na disabled atrybut tylko dla niektórych elementów, które są używane do wprowadzania danych przez użytkownika.However, the HTML 4.01 standard allows the disabled attribute only on certain elements that are used for user input. Na przykład disabled atrybut jest dozwolony dla input elementów, ale nie dla span elementów.For example, the disabled attribute is allowed for input elements, but not for span elements.

Większość przeglądarek obsługuje domyślnie wyłączony wygląd elementów tylko do wyświetlania, które mają disabled atrybuty.Most browsers support a default disabled appearance for display-only elements that have disabled attributes. Jednak w celu zapewnienia zgodności ze standardami HTML domyślnie ASP.NET 4 pomija nieprawidłowe atrybuty.However, in order to comply with HTML standards, by default ASP.NET 4 omits invalid attributes.

Jak jest używana właściwość SupportsDisabledAttributeHow the SupportsDisabledAttribute Property is Used

Jeśli SupportsDisabledAttribute Właściwość ma wartość true , ASP.NET renderuje disabled atrybut, gdy kontrolka jest wyłączona.If the SupportsDisabledAttribute property is true, ASP.NET renders a disabled attribute when the control is disabled. Jeśli ta właściwość ma wartość false , ASP.NET renderuje class atrybut, gdy kontrolka jest wyłączona.If this property is false, ASP.NET renders a class attribute when the control is disabled.

Klasy pochodne przesłaniają tę właściwość w celu zwrócenia, false jeśli spełnione są wszystkie następujące warunki:Derived classes override this property to return false if all the following conditions are true:

  • Kontrolka renderuje element HTML, który nie obsługuje disabled atrybutu.The control renders an HTML element that does not support the disabled attribute.

  • RenderingCompatibilityWłaściwość wskazuje numer wersji ASP.NET mniejszej niż 4,0.The RenderingCompatibility property indicates an ASP.NET version number lower than 4.0.

SupportsDisabledAttributeWłaściwość niekoniecznie wskazuje, czy element HTML, który jest renderowany dla kontrolki obsługuje (zezwala) na disabled atrybut.The SupportsDisabledAttribute property does not necessarily indicate whether the HTML element that is rendered for a control supports (allows) the disabled attribute. Jeśli właściwość kontrolki RenderingCompatibility wskazuje numer wersji ASP.NET niższą niż 4,0, wartość właściwości kontrolki SupportsDisabledAttribute może zwrócić true nawet wtedy, gdy renderowany kod HTML nie obsługuje disabled atrybutu.If a control's RenderingCompatibility property indicates an ASP.NET version number lower than 4.0, the value of the control's SupportsDisabledAttribute property might return true even if the rendered HTML does not support the disabled attribute.

Zgodność z poprzednimi wersjami dla wyłączonych kontrolekBackward Compatibility for Disabled Controls

W przypadku korzystania z programu Visual Studio w celu uaktualnienia projektu sieci Web do ASP.NET 4 ze starszej wersji program Visual Studio automatycznie ustawia controlRenderingCompatibilityVersion atrybut w pliku Web.config (ustawia RenderingCompatibility Właściwość) na wcześniejszy numer wersji.When you use Visual Studio to upgrade a Web project to ASP.NET 4 from an earlier version, Visual Studio automatically sets the controlRenderingCompatibilityVersion attribute in the Web.config file (which sets the RenderingCompatibility property) to the earlier version number. Ponieważ SupportsDisabledAttribute Właściwość zawsze zwraca wartość true , gdy RenderingCompatibility Właściwość jest niższa niż 4,0, powoduje to, że formanty sieci Web renderuje HTML dla wyłączonych kontrolek, tak jak w poprzedniej wersji.Because the SupportsDisabledAttribute property always returns true when the RenderingCompatibility property is lower than 4.0, this causes Web controls to render HTML for disabled controls as they did in the earlier version. 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ąć ten controlRenderingCompatibilityVersion atrybut.If you want an upgraded Web site to render HTML using the algorithm introduced in ASP.NET 4, you can change or remove the controlRenderingCompatibilityVersion attribute. Aby uzyskać więcej informacji, zobacz RenderingCompatibility Właściwość.For more information, see the RenderingCompatibility property.

Ustawianie wyłączanego wyglądu przy użyciu CSSSetting a Disabled Appearance By Using CSS

Jeśli SupportsDisabledAttribute właściwość formantu jest false , a kontrolka jest wyłączona, ASP.NET ustawia class atrybut renderowanego elementu HTML na wartość WebControl.DisabledCssClass właściwości.If the SupportsDisabledAttribute property of a control is false and the control is disabled, ASP.NET sets the class attribute of the rendered HTML element to the value of the WebControl.DisabledCssClass property. Wartość domyślna WebControl.DisabledCssClass Właściwości to "aspNetDisabled".The default value of the WebControl.DisabledCssClass property is "aspNetDisabled".

Aby zapewnić wyłączony wygląd dla wyłączonych kontrolek, należy zdefiniować regułę CSS dla klasy, która jest reprezentowana przez wartość WebControl.DisabledCssClass właściwości.To provide a disabled appearance for disabled controls, you must define a CSS rule for the class that is represented by the value of the WebControl.DisabledCssClass property.

Element HTML, który jest renderowany dla formantu może mieć więcej niż jedną wartość w jego class atrybucie, jeśli w jego właściwości znajduje się wartość CssClass .The HTML element that is rendered for a control might have more than one value in its class attribute if there is a value in its CssClass property. Aby uzyskać więcej informacji, zobacz DisabledCssClass Właściwość.For more information, see the DisabledCssClass property.

Dotyczy

Zobacz też