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

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

索引トップ用語の索引ランキング

HttpRequestCacheLevel 列挙体

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

ハイパーテキスト転送プロトコル (HTTP: Hypertext Transfer protocol) を使用して取得されるリソースのキャッシュ動作を指定します。

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

Visual Basic (宣言)

Public Enumeration HttpRequestCacheLevel

Visual Basic (使用法)

Dim instance As HttpRequestCacheLevel

public enum HttpRequestCacheLevel

C++

public enum class HttpRequestCacheLevel

public enum HttpRequestCacheLevel

JScript

public enum HttpRequestCacheLevel

メンバ

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

解説

この列挙体は、HttpRequestCachePolicy オブジェクトで指定されたキャッシュレベルを設定するために使用されます。

使用例

アプリケーションドメインのキャッシュポリシーを Default に設定するコード例を次に示します。

// The following method demonstrates overriding the
// caching policy for a request.
public static WebResponse GetResponseNoCache(Uri
 uri)
{
    // Set a default policy level for the "http:" and "https"
 schemes.
    HttpRequestCachePolicy policy = new HttpRequestCachePolicy(HttpRequestCacheLevel.Default);
    HttpWebRequest.DefaultCachePolicy = policy;
    // Create the request.
    WebRequest request = WebRequest.Create(uri);
    // Define a cache policy for this request only. 
    HttpRequestCachePolicy noCachePolicy = new HttpRequestCachePolicy(HttpRequestCacheLevel.NoCacheNoStore);
    request.CachePolicy = noCachePolicy;
    WebResponse response = request.GetResponse();
    Console.WriteLine("IsFromCache? {0}", response.IsFromCache);      
      
    return response;
}