OutputCacheProfile クラス
Web アプリケーションのページの出力キャッシュ プロファイルを構成します。
構文
class OutputCacheProfile : CollectionElement
メソッド
このクラスにはメソッドが含まれていません。
プロパティ
次の表は、OutputCacheProfile クラスによって公開されるプロパティの一覧です。
| 名前 | 説明 |
|---|---|
Duration |
ページまたはユーザー コントロールがキャッシュされる時間 (秒単位) を指定する、読み取り/書き込みの sint32 値。 既定値は –1 です。 ページまたはユーザー コントロールに対してこの属性を設定すると、ページまたはユーザー コントロールからの HTTP 応答の有効期限ポリシーが確立され、ページまたはユーザー コントロールの出力が自動的にキャッシュされます。 注: このプロパティは、プロファイルか、プロファイルを使用しているページの @ OutputCache ディレクティブで定義する必要があります。 |
Enabled |
読み取り/書き込みの boolean 値。 この出力キャッシュ プロファイルを使用するすべてのページまたはコントロールに対してキャッシュを有効にする場合は true。それ以外の場合は false。 既定値は、true です。 |
Location |
キャッシュの場所を指定する、読み取り/書き込みの sint32 値。 使用できる値の一覧は、後述の「注釈」セクションに示します。 |
Name |
出力キャッシュ プロファイルの名前を指定する読み取り専用の string 値。 |
NoStore |
読み取り/書き込みの boolean 値。 ページが HTTP 応答で、ブラウザーにページをキャッシュしないように指示する Cache-Control: Private no-store ヘッダーを発行する場合は true。それ以外の場合は false。 既定値は、false です。 注: この属性を true に設定することは、Web 要求中に System.Web.HttpCachePolicy.SetNoStore メソッドを呼び出すことと同じです。 |
SqlDependency |
ページまたはコントロールの出力キャッシュが依存する SQL データベースとテーブル名のペアのセットを識別する、読み取り/書き込みの string 値。 このプロパティに文字列を指定した場合、出力がキャッシュされたページを、それらが依存する SQL テーブルが変更されるたびに、キャッシュから削除できます。 |
VaryByControl |
キャッシュするコントロールの ID のコンマ区切りのセットを指定する、読み取り/書き込みの string 値。 注: このプロパティの設定は、@ OutputCache ディレクティブの VaryByControls 属性の設定と同じです。 |
VaryByCustom |
カスタム出力キャッシュ要件を表す、読み取り/書き込みのコンマ区切りの string 値。 このプロパティに "browser" という値を指定すると、ブラウザー名とメジャー バージョン情報によってキャッシュが変更されます。 カスタム文字列を入力する場合は、アプリケーションの Global.asax ファイル内の GetVaryByCustomString メソッドをオーバーライドする必要があります。 注: このプロパティの設定は、@ OutputCache ディレクティブの VaryByCustom 属性の設定と同じです。 |
VaryByHeader |
要求に関連付けられ、キャッシュされた出力を変更するために使用される HTTP ヘッダーのコンマ区切りのセットを指定する、読み取り/書き込みの string 値。 注: このプロパティの設定は、@ OutputCache ディレクティブの VaryByHeader 属性の設定と同じです。 |
VaryByParam |
GET クエリ文字列またはフォーム POST パラメーターによってキャッシュされた出力を変更するパラメーターのコンマ区切りのセットを指定する string 値。 注: このプロパティの設定は、@ OutputCache ディレクティブの VaryByParam 属性の設定と同じです。 |
サブクラス
このクラスにはサブクラスが含まれていません。
解説
このクラスのインスタンスは、OutputCacheProfileSettings クラスの OutputCacheProfiles 配列プロパティに含まれています。
次の表に、Location プロパティとして使用できる値の一覧を示します。
| Value | キーワード | 説明 |
|---|---|---|
| 0 | Any |
ページは、サーバー、すべての HTTP 1.1 準拠プロキシ、クライアントでキャッシュされます。 この値は、System.Web.HttpCacheability.Public 列挙値に相当します。 |
| 1 | Client |
ページは、要求元のクライアントでのみキャッシュされます。 この値は、System.Web.HttpCacheability.Private 列挙値に相当します。 |
| 2 | Downstream |
ページは、送信元サーバーを除くすべての HTTP 1.1 キャッシュ対応デバイスでキャッシュされます。 キャッシュ対応デバイスには、プロキシ サーバーと要求元のクライアントも含まれます。 |
| 3 | Server |
ページは、要求が処理された Web サーバーでのみキャッシュされます。 この値は、System.Web.HttpCacheability.Server 列挙値に相当します。 |
| 4 | None |
ページはキャッシュされません。 この値は、System.Web.HttpCacheability.NoCache 列挙値に相当します。 |
| 5 | ServerAndClient |
ページは、送信元サーバーまたは要求元クライアントでのみキャッシュされます。 プロキシ サーバーは応答をキャッシュすることはできません。 この値は、System.Web.HttpCacheability.Private 列挙値と System.Web.HttpCacheability.Server 列挙値の組み合わせに相当します。 |
継承階層
OutputCacheProfile
要件
| 型 | 説明 |
|---|---|
| クライアント | - Windows Vista 上の IIS 7.0 - Windows 7 上の IIS 7.5 - Windows 8 上の IIS 8.0 - Windows 10 上の IIS 10.0 |
| [サーバー] | - Windows Server 2008 上の IIS 7.0 - Windows Server 2008 R2 上の IIS 7.5 - Windows Server 2012 上の IIS 8.0 - Windows Server 2012 R2 上の IIS 8.5 - Windows Server 2016 上の IIS 10.0 |
| Product | - IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0 |
| MOF ファイル | WebAdministration.mof |
参照
System.Web.HttpCachePolicy.SetNoStoreSystem.Web.HttpCacheabilitySystem.Web.UI.OutputCacheLocation
CollectionElement クラス
OutputCacheSection クラス
OutputCacheSettingsSection クラス
OutputCacheProfileSettings クラス
SqlCacheDependencySection クラス
@ OutputCache
複数のバージョンのユーザー コントロール出力をキャッシュする