Control.RenderingCompatibility Control.RenderingCompatibility Control.RenderingCompatibility Control.RenderingCompatibility Property

Определение

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

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; }
member this.RenderingCompatibility : Version with get, set
Public Overridable Property RenderingCompatibility As Version

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

Версия ASP.NET, с которой совместим созданный HTML.The ASP.NET version that rendered HTML will be compatible with.

Комментарии

ASP.NET задает для этого свойства значение controlRenderingCompatibilityVersion атрибута pages элемента в файле Web. config.ASP.NET sets this property to the value of the controlRenderingCompatibilityVersion attribute of the pages element in the Web.config file. controlRenderingCompatibilityVersion Если атрибут не задан в файле Web. config, значением по умолчанию является текущая версия ASP.NET.If the controlRenderingCompatibilityVersion attribute is not set in the Web.config file, the default value is the current version of ASP.NET.

Внимание!

Для этого свойства существует открытый метод доступа set, но метод доступа set поддерживает инфраструктуру .NET Framework и не предназначен для непосредственного использования в коде.There is a public set accessor for this property, but the set accessor supports the .NET Framework infrastructure and is not intended to be used directly from your code. Если задать это значение в коде, то результат будет непредсказуемым.If you set this value in your code, the effect is unpredictable.

Каждый выпуск ASP.NET может отрисовывать HTML-код иначе, чем в предыдущих выпусках.Each release of ASP.NET might render HTML differently from earlier releases. Например, в ASP.NET 3,5, если IsEnabled свойство Label элемента управления имеет falseзначение span , по умолчанию ASP.NET визуализирует элемент, атрибут которого disabled имеет значение Disabled.For example, in ASP.NET 3.5, if the IsEnabled property of a Label control is false, by default, ASP.NET renders a span element whose disabled attribute is set to "disabled". В ASP.NET 4 по умолчанию span элемент отображается с атрибутом каскадной таблицы стилей (CSS) class вместо disabled атрибута.In ASP.NET 4, by default, the span element is rendered with a cascading style sheet (CSS) class attribute instead of the disabled attribute. Это позволяет указать отключенный внешний вид элемента управления и избежать отрисовки недопустимого HTML.This lets you specify the disabled appearance of the control and avoids rendering invalid HTML. (В HTML 4,0 и XHTML 1,1 span элемент не disabled поддерживает атрибут.)(In HTML 4.0 and XHTML 1.1, the span element does not support the disabled attribute.)

Веб-приложение может содержать код, который будет работать неправильно при изменении HTML-отрисовки.A Web application might include code that would not function correctly if HTML rendering changes. Чтобы избежать этой проблемы, можно задать controlRenderingCompatibilityVersion атрибут pages элемента в файле Web. config, чтобы указать, с какой более ранней версией требуется поддерживать совместимость.To avoid this problem, you can set the controlRenderingCompatibilityVersion attribute of the pages element in the Web.config file to indicate which earlier version you want to maintain compatibility with. Например, если RenderingCompatibility задать для 3.5свойства значение, то disabled отключенный Label элемент управления будет отображать атрибут, а не класс CSS.For example, if you set the RenderingCompatibility property to 3.5, a disabled Label control will render a disabled attribute and not a CSS class.

Примечание

Самая ранняя версия, для которой можно задать значение этого свойства, 3.5—.The earliest version that you can set this property to is 3.5.

Чтобы обеспечить обратную совместимость, при использовании Visual Studio для обновления веб-проекта до ASP.NET 4 из более ранней версии Visual Studio автоматически устанавливает controlRenderingCompatibilityVersion атрибут в 3.5файле Web. config в значение.To maintain backward compatibility, 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 to 3.5. Если вы хотите, чтобы обновленный веб-сайт отображал HTML-код с помощью алгоритма, представленного в ASP.NET 4, можно controlRenderingCompatibilityVersion изменить или удалить атрибут.If you want an upgraded Web site to render HTML using the algorithm that was introduced in ASP.NET 4, you can change or remove the controlRenderingCompatibilityVersion attribute.

В большинстве случаев поведение, управляемое этим свойством, является автоматическим, и вам не нужно проверять RenderingCompatibility свойство в коде.Most of the time, the behavior controlled by this property is automatic and you do not have to check the RenderingCompatibility property in your code. Однако при программировании пользовательского элемента управления может потребоваться включить код, который изменяет поведение элемента управления в зависимости от значения этого свойства.However, if you are programming a custom control, you might have to include code that alters the control's behavior based on the setting of this property. Например, Пользовательский элемент управления для ASP.NET 4 может состоять из Label элементов управления, а пользовательский элемент управления может определять отключенный внешний вид элемента управления путем создания кода JavaScript, который изменяет aspNetDisabled класс.For example, a custom control for ASP.NET 4 might be composed of Label controls, and the custom control might specify the disabled appearance of the control by generating JavaScript code that alters the aspNetDisabled class. Это будет работать, как ожидалось 4.0 , если RenderingCompatibility имеет значение или более поздняя.This will work as expected if RenderingCompatibility is 4.0 or later. Но чтобы получить тот же результат, RenderingCompatibility когда 3.5имеет значение, код пользовательского элемента управления CssClass должен задать для свойства элемента управления значение "аспнетдисаблед", IsEnabled если свойство falseимеет значение.But to get the same effect when RenderingCompatibility is 3.5, the custom control's code must set the control's CssClass property to "aspNetDisabled" when the IsEnabled property is false.

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

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