Control.RenderingCompatibility プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI
アセンブリ:
System.Web.dll

レンダリングされる HTML と互換性がある ASP.NET のバージョンを表す値を取得します。

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

レンダリングされる HTML と互換性がある ASP.NET のバージョン。

属性
BindableAttribute BrowsableAttribute

注釈

ASP.NET このプロパティを、Web.config ファイル内の 要素のpages属性の値controlRenderingCompatibilityVersionに設定します。 属性が controlRenderingCompatibilityVersion Web.config ファイルで設定されていない場合、既定値は現在のバージョンの ASP.NET です。

注意事項

このプロパティにはパブリック セット アクセサーがありますが、set アクセサーは.NET Framework インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 コードでこの値を設定すると、効果は予測できません。

ASP.NET の各リリースでは、以前のリリースとは異なる方法で HTML がレンダリングされる場合があります。 たとえば、ASP.NET 3.5 では、コントロールの プロパティが false既定で である場合IsEnabled、ASP.NET は属性が "disabled" に設定されている要素disabledをレンダリングspanします。Label ASP.NET 4 では、既定では、 span 要素は 属性ではなくdisabledカスケード スタイル シート (CSS) class 属性でレンダリングされます。 これにより、コントロールの無効な外観を指定でき、無効な HTML のレンダリングを回避できます。 (HTML 4.0 および XHTML 1.1 では、 span 要素は 属性を disabled サポートしていません)。

WEB アプリケーションには、HTML レンダリングが変更された場合に正しく機能しないコードが含まれる場合があります。 この問題を回避するには、Web.config ファイル内の 要素のpages属性を設定controlRenderingCompatibilityVersionして、互換性を維持する以前のバージョンを示すことができます。 たとえば、 プロパティを RenderingCompatibility に 3.5設定すると、無効 Label なコントロールは CSS クラスではなく属性をレンダリング disabled します。

注意

このプロパティを に設定できる最も古いバージョンは です 3.5。

旧バージョンとの互換性を維持するために、Visual Studio を使用して Web プロジェクトを以前のバージョンから ASP.NET 4 にアップグレードすると、Visual Studio によって、Web.config ファイル内の 属性が に自動的に3.5設定controlRenderingCompatibilityVersionされます。 アップグレードされた Web サイトで、ASP.NET 4 で導入されたアルゴリズムを使用して HTML をレンダリングする場合は、 属性を controlRenderingCompatibilityVersion 変更または削除できます。

ほとんどの場合、このプロパティによって制御される動作は自動であり、コードで プロパティを確認する RenderingCompatibility 必要はありません。 ただし、カスタム コントロールをプログラミングする場合は、このプロパティの設定に基づいてコントロールの動作を変更するコードを含める必要があります。 たとえば、ASP.NET 4 のカスタム コントロールはコントロールで Label 構成され、カスタム コントロールは クラスを変更する JavaScript コードを生成することによって、コントロールの無効な外観を aspNetDisabled 指定できます。 が 以降の場合RenderingCompatibility4.0、これは期待どおりに機能します。 ただし、 が 3.5の場合RenderingCompatibilityに同じ効果を得るには、 プロパティが の場合、カスタム コントロールのコードでコントロールのCssClassプロパティを "aspNetDisabled" に設定するIsEnabledfalse必要があります。

適用対象

こちらもご覧ください