HttpRequestCachePolicy 類別

定義

命名空間:

System.Net.Cache

組件:

System.Net.Requests.dll

來源:

HttpRequestCachePolicy.cs

定義使用 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

繼承

Object

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()	傳回這個執行個體的字串表示。

另請參閱

• 網路應用程式的快取管理