OutputCacheProfile.VaryByParam プロパティ

.NET Framework クラス ライブラリ リファレンス

OutputCacheProfile.VaryByParam プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

VaryByParam プロパティを取得または設定します。

名前空間: System.Web.Configuration
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property VaryByParam As
 String

Visual Basic (使用法)

Dim instance As OutputCacheProfile
Dim value As String

value = instance.VaryByParam

instance.VaryByParam = value

C#

public string VaryByParam { get;
 set; }

C++

public:
property String^ VaryByParam {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_VaryByParam ()

/** @property */
public void set_VaryByParam (String value)

JScript

public function get VaryByParam
 () : String

public function set VaryByParam
 (value : String)

プロパティ値
VaryByParam 値。

解説

VaryByParam は、キャッシュされる出力の変更に使用されるパラメータのコンマ区切りセットです。このプロパティにより、キャッシュされる出力を、GET クエリ文字列またはフォーム POST パラメータを使って変更できます。たとえば、クエリ文字列またはフォーム POST パラメータと共にユーザー コントロール名を指定することにより、キャッシュへのユーザー コントロールの出力を変えることができます。詳細については、「ユーザー コントロール出力の複数バージョンのキャッシュ」を参照してください。

VaryByParam 設定は、プロファイル内、またはそのプロファイルを使用するページの @ OutputCache ディレクティブで定義される必要があります。

メモ
OutputCacheProfile.VaryByParam 設定は、@ OutputCache の VaryByParam 属性で使用される設定と同じです。"*" 値を設定してすべてのパラメータごとにキャッシュされる出力を変更する方法はお勧めできません。これは、キャッシュ オーバーフローや Web サーバー上でのサービス拒否攻撃の原因になります。

使用例

VaryByParam プロパティを使用する方法を次のコード例に示します。

Visual Basic

' Get the current VaryByParam property.
Dim varyByParamValue As String
 = _
outputCacheProfile.VaryByParam
      
' Set the VaryByParam property.
outputCacheProfile.VaryByParam = _
String.Empty
      

C#

// Get the current VaryByParam.
String varyByParamValue = 
    outputCacheProfile.VaryByParam;

// Set the VaryByParam.
outputCacheProfile.VaryByParam = 
    string.Empty;

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
OutputCacheProfile クラス
OutputCacheProfile メンバ
System.Web.Configuration 名前空間
HttpCacheVaryByParams クラス
HttpCachePolicy.VaryByParams プロパティ
その他の技術情報
caching の outputCacheSettings の outputCacheProfiles 要素 (ASP.NET 設定スキーマ)
@ OutputCache
ASP.NET ページのキャッシュ
ページの複数バージョンのキャッシュ
方法 : パラメータに基づいたユーザー コントロールの複数バージョンをキャッシュする