@ OutputCache

  • [アーティクル]

ASP.NET ページ、またはページ内に含まれるユーザー コントロールの出力キャッシュ ポリシーを宣言によって制御します。 出力キャッシュの詳細については、「ASP.NET キャッシュ」を参照してください。

<%@ OutputCache Duration="#ofseconds"
   Location="Any | Client | Downstream | Server | None | 
     ServerAndClient "
   Shared="True | False"
   VaryByControl="controlname"
   VaryByCustom="browser | customstring"
   VaryByHeader="headers"
   VaryByParam="parametername" 
   VaryByContentEncoding="encodings"
   CacheProfile="cache profile name | ''"
   NoStore="true | false"
   SqlDependency="database/table name pair | CommandNotification"
   ProviderName="Provider Name"  
%>

属性

  • Duration
    ページまたはユーザー コントロールがキャッシュされる、秒単位の時間。 ページまたはユーザー コントロールでこの属性を設定すると、オブジェクトからの HTTP 応答に対する有効期限ポリシーが確立され、ページまたはユーザー コントロールの出力が自動的にキャッシュされます。

    メモメモ

    この属性は必須です。この属性を設定しないと、パーサー エラーが発生します。

  • Location
    OutputCacheLocation 列挙値のいずれか。 既定値は、Any です。

    メモメモ

    この属性は、ユーザー コントロール (.ascx ファイル) の @ OutputCache ディレクティブではサポートされません。

  • CacheProfile
    ページに関連付けるキャッシュ設定の名前。 これは省略可能な属性で、既定値は空の文字列 ("") です。

    メモメモ

    この属性は、ユーザー コントロール (.ascx ファイル) の @ OutputCache ディレクティブではサポートされません。これがページで指定されている場合、この値が outputCacheSettings セクションの outputCacheProfiles 要素で使用可能なエントリのどれかの名前と一致する必要があります。名前が一致するプロファイル エントリがない場合、例外がスローされます。

  • NoStore
    機密情報のセカンダリ記憶を実行されないようにするかどうかを指定するブール値。

    メモメモ

    この属性は、ユーザー コントロール (.ascx ファイル) の @ OutputCache ディレクティブではサポートされません。この属性を true に指定することは、要求で次のコードを実行することに相当します。

    		 
                Response.Cache.SetNoStore();

  • ProviderName
    使用するカスタム出力キャッシュ プロバイダーを識別する文字列値。 詳細については、このトピックの「解説」セクション、および Scott Guthrie のブログの「Extensible Output Caching with ASP.NET 4 (VS 2010 and .NET 4.0 Series) (ASP.NET 4 の拡張性がある出力キャッシュ (VS 2010 および .NET 4.0 シリーズ))」を参照してください。

    メモメモ

    この属性は、ユーザー コントロール (.ascx ファイル) でのみサポートされます。この属性は、ASP.NET ページ (.aspx ファイル) の @ OutputCache ディレクティブではサポートされません。

  • Shared
    ユーザー コントロール出力を複数のページで共有可能にするかどうかを指定するブール値。 既定値は、false です。 詳細については、「解説」を参照してください。

    メモメモ

    この属性は、ASP.NET ページ (.aspx ファイル) の @ OutputCache ディレクティブではサポートされません。

  • SqlDependency
    ページまたはコントロールの出力キャッシュの依存先であるデータベースのセットとテーブル名のペア示す文字列値。 SqlCacheDependency クラスは、出力キャッシュが依存するデータベース内のテーブルを監視します。これにより、テーブルの項目が更新されると、テーブル ベースのポーリングが使用された際に、更新された項目はキャッシュから削除されます。 値が CommandNotification の通知を (Microsoft SQL Server 2005 で) 使用すると、最終的に、SQL Server 2005 サーバーを使用するクエリ通知の登録には SqlDependency クラスが使用されます。

    メモメモ

    SqlDependency 属性の CommandNotification 値は、Web (.aspx) ページでのみ有効です。ユーザー コントロールで使用できるのは、@ OutputCache ディレクティブを使用したテーブル ベースのポーリングのみです。

  • VaryByCustom
    カスタム出力キャッシュ要件を表す任意のテキスト。 この属性に値 browser を設定すると、キャッシュはブラウザーの名前やメジャー バージョン情報によって切り替えられます。 カスタム文字列が入力された場合、アプリケーションの Global.asax ファイルの GetVaryByCustomString メソッドをオーバーライドする必要があります。

  • VaryByHeader
    出力キャッシュを切り替えるために使われる各 HTTP ヘッダーをセミコロンで区切ったリスト。 この属性を複数のヘッダーに設定すると、指定したヘッダーの組み合わせごとに、要求されたドキュメントの異なるバージョンが出力キャッシュに格納されます。

    メモメモ

    VaryByHeader 属性を設定すると、ASP.NET キャッシュだけでなく、すべての HTTP バージョン 1.1 キャッシュ内のアイテムをキャッシュできます。この属性は、ユーザー コントロールの @ OutputCache ディレクティブではサポートされません。

  • VaryByParam
    出力キャッシュを切り替えるために使われる各文字列をセミコロンで区切ったリスト。 既定では、これらの文字列は、GET メソッド属性を設定して送信されたクエリ文字列値、または POST メソッドを使用して送られたパラメーターに対応しています。 この属性を複数のパラメーターに設定すると、指定したパラメーターの組み合わせごとに、要求されたドキュメントの異なるバージョンが出力キャッシュに格納されます。 設定できる値には、none、*、有効な任意のクエリ文字列、POST パラメーター名があります。

    Caution メモ注意

    @ OutputCache ディレクティブを ASP.NET ページまたはユーザー コントロールで使用する場合、この属性または VaryByControl 属性が必要です。この属性を設定しないと、パーサー エラーが発生します。キャッシュされるコンテンツを切り替えるパラメーターを指定しない場合は、値を none に設定します。すべてのパラメーター値ごとに出力キャッシュを切り替えるには、この属性をアスタリスク (*) に設定します。

  • VaryByControl
    ユーザー コントロールの出力キャッシュを切り替えるために使われる各文字列をセミコロンで区切ったリスト。 これらの文字列は、ユーザー コントロールで宣言された、ASP.NET サーバー コントロールの ID プロパティ値を表します。 詳細については、「ASP.NET ページの一部だけのキャッシュ」を参照してください。

    メモメモ

    @ OutputCache ディレクティブを ASP.NET ページまたはユーザー コントロールで使用する場合、この属性または VaryByParam 属性が必要です。

  • VaryByContentEncodings
    出力キャッシュの変更に使用される文字列のセミコロン区切りのリスト。 VaryByContentEncodings 属性は、Accept-Encoding ヘッダーと共に使用して、さまざまなコンテンツ エンコーディングでのキャッシュされた応答の処理方法を決定します。 Accept-Encoding ヘッダーの指定方法の詳細については、W3C Web サイトの『Hypertext Transfer Protocol -- HTTP/1.1』仕様のセクション 14.3 を参照してください。

解説

ページ出力キャッシュに値を設定することは、SetExpires メソッドおよび SetCacheability メソッドを Cache プロパティを介して操作することと同じです。

ユーザーが Web フォーム ページを表示するために承認が必要な場合、出力キャッシュは Cache-Control HTTP ヘッダーを private に設定します。 これらのトピックの詳細については、「ASP.NET ページのキャッシュ」を参照してください。

Shared 属性を true に設定すると、複数の Web フォーム ページから、キャッシュされたユーザー コントロール出力にアクセスできます。 true に設定しなかった場合、既定では、ユーザー コントロールを含むページそれぞれに対して、ユーザー コントロール出力が 1 つずつキャッシュされます。 Shared 属性を有効にすると、大量のメモリ空間を節約できる可能性があります。 詳細については、「ASP.NET ページの一部だけのキャッシュ」を参照してください。

使用例

ページやユーザー コントロールが出力キャッシュされる期間を設定する方法を次のコード例に示します。

<%@ OutputCache Duration="100" VaryByParam="none" %>

出力キャッシュに対して、フォームの POST メソッドの location フォーム パラメーターおよび count フォーム パラメーターに従って、またはクエリ文字列に従って、ページまたはユーザー コントロールをキャッシュするよう指示する方法を、次のコード例に示します。 location または count パラメーター (またはその両方) が異なる各 HTTP 要求は、到着すると 10 秒間キャッシュされます。 同じパラメーター値を持つ後続の要求に対しては、エントリの有効期限が切れるまでキャッシュから読み込まれます。

<%@ OutputCache Duration="10" VaryByParam="location;count" %>

参照

参照

テキスト テンプレートのディレクティブの構文

概念

ASP.NET のキャッシュの概要

ASP.NET ページのキャッシュ

ASP.NET ページの一部だけのキャッシュ

ASP.NET Web ページの構文の概要