HttpRequestCachePolicy 類別

定義

命名空間:

System.Net.Cache

組件:

netstandard.dll, 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.
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 應用程式或機器設定檔的屬性來指定應用程式的預設快取政策。 更多資訊請參閱<請求快取>元素（網路設定）。

你可以透過屬性 CachePolicy 來指定個別請求的快取政策。

不支援網路服務的快取。

建構函式

名稱	Description
HttpRequestCachePolicy()	初始化 HttpRequestCachePolicy 類別的新執行個體。
HttpRequestCachePolicy(DateTime)	使用指定的快取同步日期初始化該類別的新實例 HttpRequestCachePolicy 。
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	使用指定的最大年齡、年齡控制值、時間值及快取同步日期初始化該類別的新實例 HttpRequestCachePolicy 。
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	使用指定的最大年齡、年齡控制值及時間值初始化該類別的新實例 HttpRequestCachePolicy 。
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	使用指定的年齡控制與時間值初始化該類別的新實例 HttpRequestCachePolicy 。
HttpRequestCachePolicy(HttpRequestCacheLevel)	使用指定的快取策略初始化該 HttpRequestCachePolicy 類別的新實例。

屬性

名稱	Description
CacheSyncDate	取得此實例的快取同步日期。
Level	取得 HttpRequestCacheLevel 建立此實例時指定的值。
MaxAge	取得從快取回傳資源的最大允許年齡。
MaxStale	取得從快取回傳資源允許的最大過期值。
MinFresh	獲得從快取回傳資源所允許的最低新鮮度。

方法

名稱	Description
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	回傳此實例的字串表示。

另請參閱

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