RequestCacheLevel 列挙体とは何？わかりやすく解説 Weblio辞書

.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

public enum RequestCacheLevel

C++

public enum class RequestCacheLevel

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 プロパティで取得できます。

使用例

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

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;
    
}