Control.RenderingCompatibility Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, указывающее версию 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, setPublic Overridable Property RenderingCompatibility As VersionЗначение свойства
Версия ASP.NET, с которую отрисовывается HTML, будет совместима.
- Атрибуты
Комментарии
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 имеет значение "отключено". В ASP.NET 4 по умолчанию span элемент отображается с каскадным атрибутом таблицы стилей (CSS), class а не атрибутом disabled . Это позволяет указать отключенный внешний вид элемента управления и избежать отрисовки недопустимого HTML-кода. (В HTML 4.0 и XHTML 1.1 span элемент не поддерживает disabled атрибут.)
Веб-приложение может включать код, который не будет работать правильно, если изменения отрисовки HTML. Чтобы избежать этой проблемы, можно задать controlRenderingCompatibilityVersion атрибут pages элемента в файле Web.config, чтобы указать, с какой более ранней версией требуется обеспечить совместимость. Например, если для свойства задано RenderingCompatibility значение 3.5, отключенный Label элемент управления отрисовывает disabled атрибут, а не класс CSS.
Замечание
Самая ранняя версия, которую можно задать для 3.5этого свойства.
Чтобы обеспечить обратную совместимость, при использовании Visual Studio для обновления веб-проекта до ASP.NET 4 из более ранней версии Visual Studio автоматически устанавливает controlRenderingCompatibilityVersion атрибут в файле 3.5Web.config. Если требуется, чтобы обновленный веб-сайт отображал HTML с помощью алгоритма, введенного в ASP.NET 4, можно изменить или удалить controlRenderingCompatibilityVersion атрибут.
Большую часть времени поведение, управляемое этим свойством, является автоматическим, и вам не нужно проверять RenderingCompatibility свойство в коде. Однако при программировании пользовательского элемента управления может потребоваться включить код, который изменяет поведение элемента управления на основе параметра этого свойства. Например, пользовательский элемент управления для ASP.NET 4 может состоять Label из элементов управления, а пользовательский элемент управления может указать отключенный внешний вид элемента управления, создав код JavaScript, который изменяет aspNetDisabled класс. Это будет работать должным образом, если RenderingCompatibility это 4.0 или более поздняя версия. Но чтобы получить тот же эффект, когда RenderingCompatibility это 3.5происходит, код пользовательского элемента управления должен задать для свойства элемента управления CssClass значение aspNetDisabled, если IsEnabled это falseсвойство.
