WebControl.SupportsDisabledAttribute WebControl.SupportsDisabledAttribute WebControl.SupportsDisabledAttribute WebControl.SupportsDisabledAttribute Property

Определение

Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута disabled отрисовываемого элемента HTML значение disabled, если для свойства элемента управления IsEnabled задано значение 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; }
member this.SupportsDisabledAttribute : bool
Public Overridable ReadOnly Property SupportsDisabledAttribute As Boolean

Значение свойства

Всегда true.Always true.

Примеры

В следующем примере показана разметка для Label отключенного элемента управления:The following example shows markup for a disabled Label control:

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

В ASP.NET 3,5 и более ранних версиях эта разметка отображает следующий HTML-код:In ASP.NET 3.5 and earlier versions, this markup renders the following HTML:

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

В ASP.NET 4, если значение RenderingCompatibility свойства 4,0 или больше, и DisabledCssClass если для свойства задано значение по умолчанию, то та же разметка визуализирует следующий 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>

Комментарии

В производных классах это свойство указывает, как ASP.NET должен отображать HTML для элемента управления, когда элемент управления отключен.In derived classes, this property indicates how ASP.NET should render HTML for a control when the control is disabled.

Отключение веб-элементов управления ASP.NETDisabling ASP.NET Web Controls

Если свойство элемента управления ASP.NET имеет false значение (то есть, когда элемент управления отключен), цель заключается в том, что ASP.NET должен визуализировать элемент управления на странице, но отображать его в отключенном состоянии (обычно затемнены). EnabledWhen 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). Если родительский элемент управления отключен, дочерние элементы этого элемента управления также отображаются как отключенные.If a parent control is disabled, children of that control are also displayed as disabled. В этом случае IsEnabled свойство дочернего элемента управления имеет falseзначение, даже если его Enabled свойство может иметь значение true.In that case, the child control's IsEnabled property is set to false, even though its Enabled property might be set to true.

В ASP.NET 3,5 и более ранних версиях, когда IsEnabled свойство элемента управления имеет falseзначение, ASP.NET disabled устанавливает для атрибута значение "Disabled" в HTML-элементе, который он отображает для элемента управления.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. Однако стандарт HTML 4,01 позволяет disabled атрибуту только для определенных элементов, используемых для ввода данных пользователем.However, the HTML 4.01 standard allows the disabled attribute only on certain elements that are used for user input. Например, disabled атрибут разрешен для input элементов, но не для span элементов.For example, the disabled attribute is allowed for input elements, but not for span elements.

Большинство браузеров поддерживают отключенный внешний вид по умолчанию для элементов только disabled для отображения, имеющих атрибуты.Most browsers support a default disabled appearance for display-only elements that have disabled attributes. Однако для соответствия стандартам HTML по умолчанию ASP.NET 4 пропускает недопустимые атрибуты.However, in order to comply with HTML standards, by default ASP.NET 4 omits invalid attributes.

Использование свойства СуппортсдисабледаттрибутеHow the SupportsDisabledAttribute Property is Used

Если свойство имеет true значениеdisabled , ASP.NET отображает атрибут, когда элемент управления отключен. SupportsDisabledAttributeIf the SupportsDisabledAttribute property is true, ASP.NET renders a disabled attribute when the control is disabled. Если это свойство имеет falseзначение, ASP.NET отображает class атрибут, когда элемент управления отключен.If this property is false, ASP.NET renders a class attribute when the control is disabled.

Производные классы переопределяют это свойство false , чтобы оно возвращалось, если выполняются все перечисленные ниже условия.Derived classes override this property to return false if all the following conditions are true:

  • Элемент управления визуализирует элемент HTML, который не поддерживает этот disabled атрибут.The control renders an HTML element that does not support the disabled attribute.

  • RenderingCompatibility Свойство указывает номер версии ASP.NET ниже 4,0.The RenderingCompatibility property indicates an ASP.NET version number lower than 4.0.

Свойство не обязательно указывает, поддерживает ли disabled атрибут элемент HTML, который визуализируется для элемента управления (допускает). SupportsDisabledAttributeThe SupportsDisabledAttribute property does not necessarily indicate whether the HTML element that is rendered for a control supports (allows) the disabled attribute. Если RenderingCompatibility свойство элемента управления указывает номер версии ASP.NET ниже 4,0, значение SupportsDisabledAttribute свойства элемента управления может возвращаться true даже в том disabled случае, если отображаемый HTML-код не поддерживает атрибут.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.

Обратная совместимость для отключенных элементов управленияBackward Compatibility for Disabled Controls

При использовании Visual Studio для обновления веб-проекта до ASP.NET 4 из более ранней версии Visual Studio автоматически задает controlRenderingCompatibilityVersion атрибут в файле Web. config (который RenderingCompatibility задает свойство) в качестве более ранней версии.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. Поскольку свойство всегда возвращает true значение, если RenderingCompatibility свойство меньше 4,0, это приводит к тому, что веб-элементы управления отображают HTML для отключенных элементов управления, как в предыдущей версии. SupportsDisabledAttributeBecause 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. Если вы хотите, чтобы обновленный веб-сайт отображал HTML-код с помощью алгоритма, представленного в ASP.NET 4 controlRenderingCompatibilityVersion , можно изменить или удалить атрибут.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. Дополнительные сведения см. в описании свойства RenderingCompatibility.For more information, see the RenderingCompatibility property.

Установка отключенного внешнего вида с помощью CSSSetting a Disabled Appearance By Using CSS

Если свойство элемента управления имеет false значение и элемент управления class отключен, ASP.NET устанавливает атрибут WebControl.DisabledCssClass отображаемого элемента HTML равным значению свойства. SupportsDisabledAttributeIf 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. Значение WebControl.DisabledCssClass свойства по умолчанию — "аспнетдисаблед".The default value of the WebControl.DisabledCssClass property is "aspNetDisabled".

Чтобы предоставить отключенный внешний вид для отключенных элементов управления, необходимо определить правило CSS для класса, представленного значением WebControl.DisabledCssClass свойства.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.

Элемент HTML, отображаемый для элемента управления, может иметь в его class атрибуте более одного значения, если в его 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. Дополнительные сведения см. в описании свойства DisabledCssClass.For more information, see the DisabledCssClass property.

Применяется к

Дополнительно