HttpRequestCachePolicy クラス

定義

HttpWebRequest オブジェクトを使用して取得されるリソースに対するアプリケーションのキャッシュ要件を定義します。

public ref class HttpRequestCachePolicy : System::Net::Cache::RequestCachePolicy
public class HttpRequestCachePolicy : System.Net.Cache.RequestCachePolicy
type HttpRequestCachePolicy = class
    inherit RequestCachePolicy
Public Class HttpRequestCachePolicy
Inherits RequestCachePolicy
継承
HttpRequestCachePolicy

次のコード例では、アプリケーション ドメインの既定のキャッシュ ポリシーを作成し、要求に対してオーバーライドします。

// The following method demonstrates overriding the
// caching policy for a request.
static WebResponse^ GetResponseNoCache( Uri^ uri )
{
   // Set a default policy level for the "http:" and "https" schemes.
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpRequestCacheLevel::Default );
   HttpWebRequest::DefaultCachePolicy = policy;

   // Create the request.
   WebRequest^ request = WebRequest::Create( uri );

   // Define a cache policy for this request only. 
   HttpRequestCachePolicy^ noCachePolicy = gcnew HttpRequestCachePolicy( HttpRequestCacheLevel::NoCacheNoStore );
   request->CachePolicy = noCachePolicy;
   WebResponse^ response = request->GetResponse();
   Console::WriteLine( L"IsFromCache? {0}", response->IsFromCache );
   
   return response;
}
// 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;
}

注釈

プロパティまたはアプリケーションまたはコンピューター構成ファイルを使用して、アプリケーションの DefaultCachePolicy 既定のキャッシュ ポリシーを指定できます。 詳細については、「<requestCaching> 要素 (ネットワーク設定)」を参照してください。

プロパティを使用して、個々の要求のキャッシュ ポリシーを CachePolicy 指定できます。

Web サービスのキャッシュはサポートされていません。

コンストラクター

HttpRequestCachePolicy()

HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

HttpRequestCachePolicy(DateTime)

キャッシュ同期日時を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

保存期間の制御と日時の値を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

有効期限、保存期間の制御値、日時の値を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

有効期限、保存期間の制御値、日時の値、キャッシュ同期日時を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

HttpRequestCachePolicy(HttpRequestCacheLevel)

キャッシュ ポリシーを指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。

プロパティ

CacheSyncDate

このインスタンスのキャッシュ同期日時を取得します。

Level

このインスタンスが作成されたときに指定された HttpRequestCacheLevel 値を取得します。

MaxAge

キャッシュから返されるリソースに許可されている有効期限を取得します。

MaxStale

キャッシュから返されるリソースに許可される延長期限を取得します。

MinFresh

キャッシュから返されるリソースに許可される短縮期限を取得します。

メソッド

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
ToString()

このインスタンスの文字列形式を返します。

適用対象

こちらもご覧ください