WebControl.SupportsDisabledAttribute Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута disabled отрисовываемого элемента HTML значение disabled, если для свойства элемента управления IsEnabled задано значение 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 BooleanЗначение свойства
Всегда true.
- Атрибуты
Примеры
В следующем примере показана разметка для отключенного Label элемента управления:
<asp:Label id="Label1" runat="server" Text="Test" Enabled="false"/>
В ASP.NET 3.5 и более ранних версиях эта разметка отображает следующий HTML-код:
<span id="Label1" disabled="disabled">Test</span>
В ASP.NET 4, если значение RenderingCompatibility свойства равно 4,0 или выше, а DisabledCssClass для свойства задано значение по умолчанию, то та же разметка отображает следующий КОД HTML:
<span id="Label1" class="aspNetDisabled">Test</span>
Комментарии
В производных классах это свойство указывает, как ASP.NET должен отображать HTML для элемента управления при отключении элемента управления.
Отключение веб-элементов управления ASP.NET
Если свойству Enabled элемента управления ASP.NET присвоено значение false (т. е. при отключении элемента управления), цель заключается в том, что ASP.NET должен отображать элемент управления на странице, но отображать его в отключенном состоянии (обычно неактивном). Если родительский элемент управления отключен, дочерние элементы этого элемента управления также отображаются как отключенные. В этом случае свойству дочернего IsEnabled элемента управления присваивается значение false, хотя его Enabled свойству может быть присвоено значение true.
В ASP.NET 3.5 и более ранних версиях, когда свойство элемента управления IsEnabled имеет значение false, ASP.NET задает disabled атрибуту значение disabled в элементе HTML, который он отображает для элемента управления. Однако стандарт HTML 4.01 позволяет использовать disabled атрибут только для определенных элементов, которые используются для ввода данных пользователем. Например, disabled атрибут разрешен для input элементов, но не для span элементов.
Большинство браузеров поддерживают отключенный внешний вид по умолчанию для отображаемых элементов с disabled атрибутами. Однако для соответствия стандартам HTML по умолчанию ASP.NET 4 пропускают недопустимые атрибуты.
Использование свойства SupportsDisabledAttribute
SupportsDisabledAttribute Если свойство имеет значение true, ASP.NET отображает disabled атрибут при отключении элемента управления. Если это свойство имеет значение false, ASP.NET отрисовывает class атрибут при отключении элемента управления.
Производные классы переопределяют это свойство для возврата false , если выполняются все следующие условия:
Элемент управления отрисовывает элемент HTML, который не поддерживает
disabledатрибут .Свойство RenderingCompatibility указывает номер версии ASP.NET ниже 4.0.
Свойство SupportsDisabledAttribute не обязательно указывает, поддерживает ли html-элемент, отображаемый для элемента управления, атрибут .disabled Если свойство элемента управления RenderingCompatibility указывает номер версии ASP.NET ниже 4.0, значение свойства элемента управления SupportsDisabledAttribute может возвращать true , даже если отображаемый HTML-код не поддерживает disabled атрибут .
Обратная совместимость для отключенных элементов управления
При использовании Visual Studio для обновления веб-проекта до ASP.NET 4 с более ранней версии Visual Studio автоматически устанавливает controlRenderingCompatibilityVersion для атрибута в файле Web.config (который задает RenderingCompatibility свойство) номер предыдущей версии.
SupportsDisabledAttribute Поскольку свойство всегда возвращает значение true , если RenderingCompatibility значение свойства меньше 4.0, это приводит к тому, что веб-элементы управления будут отображать HTML для отключенных элементов управления, как и в более ранней версии. Если вы хотите, чтобы обновленный веб-сайт отображал HTML с помощью алгоритма, представленного в ASP.NET 4, можно изменить или удалить controlRenderingCompatibilityVersion атрибут . Дополнительные сведения см. в описании свойства RenderingCompatibility.
Настройка отключенного внешнего вида с помощью CSS
SupportsDisabledAttribute Если свойство элемента управления равно false , а элемент управления отключен, ASP.NET присваивает class атрибуту отображаемого HTML-элемента значение WebControl.DisabledCssClass свойства . Значение свойства по умолчанию WebControl.DisabledCssClass — "aspNetDisabled".
Чтобы обеспечить отключенный внешний вид для отключенных элементов управления, необходимо определить правило CSS для класса, представленного значением WebControl.DisabledCssClass свойства .
Html-элемент, отображаемый для элемента управления, может иметь несколько значений в его class атрибуте, если в его CssClass свойстве есть значение. Дополнительные сведения см. в описании свойства DisabledCssClass.
