Control.RenderingCompatibility Свойство

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.

public:
 virtual property Version ^ RenderingCompatibility { Version ^ get(); void set(Version ^ value); };

[System.ComponentModel.Bindable(false)]
[System.ComponentModel.Browsable(false)]
public virtual Version RenderingCompatibility { get; set; }

[<System.ComponentModel.Bindable(false)>]
[<System.ComponentModel.Browsable(false)>]
member this.RenderingCompatibility : Version with get, set

Public Overridable Property RenderingCompatibility As Version

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

Version

Версия ASP.NET, с которой совместим созданный HTML.

Атрибуты

BindableAttribute BrowsableAttribute

Комментарии

ASP.NET присваивает этому свойству значение controlRenderingCompatibilityVersion атрибута pages элемента в файле Web.config. controlRenderingCompatibilityVersion Если атрибут не задан в файле Web.config, значением по умолчанию является текущая версия ASP.NET.

Внимание!

Для этого свойства существует открытый метод доступа к набору, но метод доступа set поддерживает инфраструктуру платформа .NET Framework и не предназначен для использования непосредственно из кода. Если задать это значение в коде, эффект будет непредсказуемым.

Каждый выпуск ASP.NET может отображать HTML-код по-разному, чем предыдущие выпуски. Например, в ASP.NET 3.5, если IsEnabled свойство Label элемента управления по умолчанию равно false, ASP.NET отрисовывает span элемент, атрибут которого disabled имеет значение "disabled". В ASP.NET 4 по умолчанию span элемент отображается с помощью атрибута каскадной таблицы стилей (CSS) class вместо атрибута disabled . Это позволяет указать отключенный внешний вид элемента управления и избежать отрисовки недопустимого HTML-кода. (В HTML 4.0 и XHTML 1.1 span элемент не поддерживает disabled атрибут.)

Веб-приложение может включать код, который будет работать неправильно при изменении html-отрисовки. Чтобы избежать этой проблемы, можно задать controlRenderingCompatibilityVersion атрибут pages элемента в файле Web.config, чтобы указать, с какой более ранней версией требуется поддерживать совместимость. Например, если для свойства задано значение RenderingCompatibility3.5, отключенный Label элемент управления будет отображать атрибут, disabled а не класс CSS.

Примечание

Самая ранняя версия, в которую можно задать это свойство, — .3.5

Для обеспечения обратной совместимости при использовании Visual Studio для обновления веб-проекта до ASP.NET 4 с более ранней версии Visual Studio автоматически задает controlRenderingCompatibilityVersion атрибуту в файле Web.config значение 3.5. Если вы хотите, чтобы обновленный веб-сайт отображал HTML с помощью алгоритма, представленного в ASP.NET 4, можно изменить или удалить controlRenderingCompatibilityVersion атрибут .

В большинстве случаев поведение, управляемое этим свойством, является автоматическим, и вам не нужно проверять свойство в коде RenderingCompatibility . Однако при программировании пользовательского элемента управления может потребоваться включить код, который изменяет поведение элемента управления на основе настройки этого свойства. Например, пользовательский элемент управления для ASP.NET 4 может состоять из Label элементов управления, а настраиваемый элемент управления может указывать отключенный внешний вид элемента управления путем создания кода JavaScript, который изменяет aspNetDisabled класс . Это будет работать должным образом, если RenderingCompatibility имеет значение 4.0 или более поздней версии. Но чтобы получить тот же эффект, если имеет значение 3.5, код пользовательского элемента управления должен задать для свойства элемента управления CssClass значение "aspNetDisabled", если IsEnabled свойство имеет значение false.RenderingCompatibility

См. также раздел

• ControlRenderingCompatibilityVersion