RequestCacheLevel 列挙体

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

RequestCacheLevel 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

WebRequest およびその派生クラスを使用して取得されるリソースのキャッシュ動作を指定します。

名前空間: System.Net.Cache
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Enumeration RequestCacheLevel

Visual Basic (使用法)

Dim instance As RequestCacheLevel

C#

public enum RequestCacheLevel

C++

public enum class RequestCacheLevel

J#

public enum RequestCacheLevel

JScript

public enum RequestCacheLevel

メンバ

	メンバ名	説明
	BypassCache	サーバーを使用して要求に応じます。クライアントとサーバー間では、エントリはキャッシュから取得したり、キャッシュに追加、またはキャッシュから削除したりはされません。これは、.NET Framework と共に配布されるコンピュータの構成ファイルで指定されている既定のキャッシュ動作です。
	CacheIfAvailable	リソースが利用可能な場合は、キャッシュからリソースの要求に応じます。それ以外の場合は、リソースの要求をサーバーに送信します。要求されたアイテムがクライアントとサーバー間のキャッシュにある場合は、その中間キャッシュから要求に応じることもあります。
	CacheOnly	ローカルにキャッシュされたリソースを使用して要求に応じ、キャッシュにないアイテムの要求は送信しません。このキャッシュ ポリシーレベルが指定されている場合、アイテムがクライアントのキャッシュになければ WebException 例外がスローされます。
	Default	キャッシュされたリソースのコピーを使用するか、リソースの要求をサーバーに送信して、リソースの要求に応じます。実行される動作は、現在のキャッシュ ポリシーとキャッシュ内のコンテンツの世代によって決まります。これが、ほとんどのアプリケーションで使用されるキャッシュ レベルです。
	NoCacheNoStore	キャッシュのリソースを使用して要求に応じることはなく、リソースをキャッシュしません。リソースがローカル キャッシュに存在する場合は、削除されます。このポリシー レベルは、中間キャッシュに、リソースをキャッシュから削除する必要があることを示します。HTTP キャッシュ プロトコルの場合、これは no-cache キャッシュ制御ディレクティブを使用して実現されます。
	Reload	サーバーを使用して要求に応じます。応答は、キャッシュに保存される可能性があります。HTTP キャッシュ プロトコルの場合、これは no-cache キャッシュ制御ディレクティブおよび no-cache Pragma ヘッダーを使用して実現されます。
	Revalidate	タイムスタンプがサーバーのリソースのタイムスタンプと同じ場合は、キャッシュされたリソースのコピーを使用して要求に応じます。それ以外の場合は、リソースがキャッシュからダウンロードされ、呼び出し元に提示され、キャッシュに格納されます。

解説

この列挙体のメンバは、RequestCachePolicy オブジェクトを初期化するために使用されます。RequestCachePolicy オブジェクトの現在の設定は、RequestCachePolicy.Level プロパティで取得できます。

使用例

リソースがキャッシュに格納されている場合だけそのリソースを返すポリシーを作成するコード例を次に示します。

C#

public static WebResponse GetResponseFromCache(Uri
 uri)
{
     RequestCachePolicy policy = 
        new  RequestCachePolicy( RequestCacheLevel.CacheOnly);
    WebRequest request = WebRequest.Create(uri);
    request.CachePolicy = policy;
    WebResponse response = request.GetResponse();
    Console.WriteLine("Policy level is {0}.", policy.Level.ToString());
    Console.WriteLine("Is the response from the cache? {0}", response.IsFromCache);
  
    return response;
    
} 

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
System.Net.Cache 名前空間
その他の技術情報
ネットワーク アプリケーションのキャッシュ管理
requestCaching 要素 (ネットワーク設定)