Control.RenderingCompatibility Właściwość

Definicja

Pobiera wartość określającą ASP.NET wersję, która będzie zgodna z językiem 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

Wartość właściwości

Version

Wersja ASP.NET, która renderowanego kodu HTML będzie zgodna z programem.The ASP.NET version that rendered HTML will be compatible with.

Atrybuty

Uwagi

ASP.NET ustawia tę właściwość na wartość atrybutu controlRenderingCompatibilityVersion elementu pages w pliku Web. config.ASP.NET sets this property to the value of the controlRenderingCompatibilityVersion attribute of the pages element in the Web.config file. Jeśli atrybut controlRenderingCompatibilityVersion nie jest ustawiony w pliku Web. config, wartością domyślną jest bieżąca wersja ASP.NET.If the controlRenderingCompatibilityVersion attribute is not set in the Web.config file, the default value is the current version of ASP.NET.

Przestroga

Istnieje metoda dostępu do zestawu publicznego dla tej właściwości, ale metoda dostępu set obsługuje infrastrukturę .NET Framework i nie jest przeznaczona do użycia bezpośrednio w kodzie.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. Jeśli ustawisz tę wartość w kodzie, efekt będzie nieprzewidywalny.If you set this value in your code, the effect is unpredictable.

Każda wersja programu ASP.NET może renderować kod HTML inaczej niż w poprzednich wersjach.Each release of ASP.NET might render HTML differently from earlier releases. Na przykład w ASP.NET 3,5, jeśli właściwość IsEnabled kontrolki Label jest false, domyślnie ASP.NET renderuje element span, którego atrybut disabled jest ustawiony na wartość "wyłączone".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". W ASP.NET 4 Domyślnie element span jest renderowany przy użyciu kaskadowego arkusza stylów (CSS class), a nie atrybutu 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. Pozwala to na określenie wyłączonego wyglądu kontrolki i uniknięcie renderowania nieprawidłowego kodu HTML.This lets you specify the disabled appearance of the control and avoids rendering invalid HTML. (W języku HTML 4,0 i XHTML 1,1 element span nie obsługuje atrybutu disabled).(In HTML 4.0 and XHTML 1.1, the span element does not support the disabled attribute.)

Aplikacja sieci Web może zawierać kod, który nie działa poprawnie, jeśli renderowanie HTML zostanie zmienione.A Web application might include code that would not function correctly if HTML rendering changes. Aby uniknąć tego problemu, można ustawić atrybut controlRenderingCompatibilityVersion elementu pages w pliku Web. config, aby wskazać, która wcześniejsza wersja ma zachować zgodność z programem.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. Na przykład jeśli ustawisz właściwość RenderingCompatibility na 3.5, wyłączona kontrolka Label będzie renderować atrybut disabled, a nie klasę 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.

Uwaga

Najwcześniejsza wersja, do której można ustawić tę właściwość, jest 3.5.The earliest version that you can set this property to is 3.5.

Aby zachować zgodność z poprzednimi wersjami, w przypadku korzystania z programu Visual Studio w celu uaktualnienia projektu sieci Web do ASP.NET 4 ze starszej wersji program Visual Studio automatycznie ustawia atrybut controlRenderingCompatibilityVersion w pliku Web. config, aby 3.5.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. Jeśli chcesz, aby uaktualniona witryna sieci Web renderować HTML przy użyciu algorytmu, który został wprowadzony w ASP.NET 4, możesz zmienić lub usunąć atrybut 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.

W większości przypadków zachowanie kontrolowane przez tę właściwość jest automatyczne i nie trzeba sprawdzać właściwości RenderingCompatibility w kodzie.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. Jeśli jednak tworzysz kontrolkę niestandardową, może być konieczne dołączenie kodu, który zmienia zachowanie kontrolki na podstawie ustawienia tej właściwości.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. Na przykład kontrolka niestandardowa dla ASP.NET 4 może składać się z kontrolek Label, a kontrolka niestandardowa może określić wyłączony wygląd formantu, generując kod JavaScript, który modyfikuje klasę 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. Będzie to działało zgodnie z oczekiwaniami, jeśli RenderingCompatibility jest 4.0 lub nowszy.This will work as expected if RenderingCompatibility is 4.0 or later. Aby jednak uzyskać ten sam efekt, gdy RenderingCompatibility jest 3.5, kod kontrolki niestandardowej musi ustawić właściwość CssClass kontrolki na wartość "aspNetDisabled", gdy właściwość IsEnabled jest 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.

Dotyczy

Zobacz też