HttpRequestCachePolicy HttpRequestCachePolicy HttpRequestCachePolicy HttpRequestCachePolicy Class

定義

HttpWebRequest オブジェクトを使用して取得されるリソースに対するアプリケーションのキャッシュ要件を定義します。Defines an application's caching requirements for resources obtained by using HttpWebRequest objects.

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
継承
HttpRequestCachePolicyHttpRequestCachePolicyHttpRequestCachePolicyHttpRequestCachePolicy

次のコード例は、アプリケーション ドメインの既定のキャッシュ ポリシーを作成し、要求に対してオーバーライドします。The following code example creates a default cache policy for the application domain, and overrides it for a request.

// 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プロパティまたはアプリケーションまたはマシン構成ファイル。You can specify a default cache policy for your application by using the DefaultCachePolicy property or the application or machine configuration files. 詳細については、次を参照してください。 <requestCaching>要素 (ネットワーク設定)します。For more information, see <requestCaching> Element (Network Settings).

使用して、個々 の要求のキャッシュ ポリシーを指定することができます、CachePolicyプロパティ。You can specify the cache policy for an individual request by using the CachePolicy property.

Web サービスのキャッシュはサポートされていません。Caching for Web services is not supported.

コンストラクター

HttpRequestCachePolicy() HttpRequestCachePolicy() HttpRequestCachePolicy() HttpRequestCachePolicy()

HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpRequestCachePolicy class.

HttpRequestCachePolicy(DateTime) HttpRequestCachePolicy(DateTime) HttpRequestCachePolicy(DateTime) HttpRequestCachePolicy(DateTime)

キャッシュ同期日時を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpRequestCachePolicy class using the specified cache synchronization date.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

保存期間の制御と日時の値を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpRequestCachePolicy class using the specified age control and time values.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

有効期限、保存期間の制御値、日時の値を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpRequestCachePolicy class using the specified maximum age, age control value, and time value.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

有効期限、保存期間の制御値、日時の値、キャッシュ同期日時を指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpRequestCachePolicy class using the specified maximum age, age control value, time value, and cache synchronization date.

HttpRequestCachePolicy(HttpRequestCacheLevel) HttpRequestCachePolicy(HttpRequestCacheLevel) HttpRequestCachePolicy(HttpRequestCacheLevel) HttpRequestCachePolicy(HttpRequestCacheLevel)

キャッシュ ポリシーを指定して、HttpRequestCachePolicy クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpRequestCachePolicy class using the specified cache policy.

プロパティ

CacheSyncDate CacheSyncDate CacheSyncDate CacheSyncDate

このインスタンスのキャッシュ同期日時を取得します。Gets the cache synchronization date for this instance.

Level Level Level Level

このインスタンスが作成されたときに指定された HttpRequestCacheLevel 値を取得します。Gets the HttpRequestCacheLevel value that was specified when this instance was created.

MaxAge MaxAge MaxAge MaxAge

キャッシュから返されるリソースに許可されている有効期限を取得します。Gets the maximum age permitted for a resource returned from the cache.

MaxStale MaxStale MaxStale MaxStale

キャッシュから返されるリソースに許可される延長期限を取得します。Gets the maximum staleness value that is permitted for a resource returned from the cache.

MinFresh MinFresh MinFresh MinFresh

キャッシュから返されるリソースに許可される短縮期限を取得します。Gets the minimum freshness that is permitted for a resource returned from the cache.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

このインスタンスの文字列形式を返します。Returns a string representation of this instance.

適用対象

こちらもご覧ください