WebControl.SupportsDisabledAttribute Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, указывающее, должен ли элемент управления задать disabled атрибут отрисованного HTML-элемента значение "отключено" при наличии falseсвойства элемента управленияIsEnabled.
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 атрибут "отключено" в элементе HTML, который он отображает для элемента УПРАВЛЕНИЯ. Однако стандарт HTML 4.01 разрешает disabled атрибут только для определенных элементов, используемых для ввода пользователем. Например, disabled атрибут разрешен для input элементов, но не для span элементов.
Большинство браузеров поддерживают отключенный по умолчанию внешний вид для элементов только для отображения, имеющих disabled атрибуты. Однако для соблюдения стандартов HTML по умолчанию ASP.NET 4 недействительна.
Как используется свойство SupportsDisabledAttribute
SupportsDisabledAttribute Если свойство равноtrue, ASP.NET отрисовывает disabled атрибут при отключении элемента управления. Если это свойство имеет значение false, ASP.NET отрисовывает class атрибут при отключении элемента управления.
Производные классы переопределяют это свойство, чтобы вернуться false , если все следующие условия имеют значение true:
Элемент управления отображает HTML-элемент, который не поддерживает
disabledатрибут.Свойство RenderingCompatibility указывает номер версии ASP.NET ниже 4.0.
Свойство SupportsDisabledAttribute не обязательно указывает, поддерживает ли элемент HTML, отрисованный для элемента управления (разрешает) disabled атрибут. Если свойство элемента управления указывает номер версии ASP.NET ниже 4.0, значение свойства элемента RenderingCompatibility управления SupportsDisabledAttribute может вернуться true , даже если отрисованный HTML не поддерживает disabled атрибут.
Обратная совместимость для отключенных элементов управления
При использовании Visual Studio для обновления веб-проекта до ASP.NET 4 из более ранней версии Visual Studio автоматически задает атрибут в файле Web.config (который задает controlRenderingCompatibilityVersionRenderingCompatibility свойство) на более ранний номер версии.
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, отображаемый для элемента управления, может иметь несколько значений в атрибуте, если в его classCssClass свойстве есть значение. Дополнительные сведения см. в свойстве DisabledCssClass.
