HttpRequestCachePolicy Класс

Определение

Определяет требования приложения к кэшированию ресурсов, получаемых с помощью объектов 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
Наследование
HttpRequestCachePolicy

Примеры

В следующем примере кода создается политика кэша по умолчанию для домена приложения и переопределяется для запроса.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.

Кэширование для веб-служб не поддерживается.Caching for Web services is not supported.

Конструкторы

HttpRequestCachePolicy()

Инициализирует новый экземпляр класса HttpRequestCachePolicy.Initializes a new instance of the HttpRequestCachePolicy class.

HttpRequestCachePolicy(DateTime)

Инициализирует новый экземпляр класса HttpRequestCachePolicy, используя указанную дату синхронизации кэша.Initializes a new instance of the HttpRequestCachePolicy class using the specified cache synchronization date.

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, используя указанное максимальное время существования, значение контроля времени существования и значение времени.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, используя указанное максимальное время существования, значение контроля времени существования, значение времени и дату синхронизации кэша.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, используя указанную политику кэша.Initializes a new instance of the HttpRequestCachePolicy class using the specified cache policy.

Свойства

CacheSyncDate

Возвращает дату синхронизации кэша для этого экземпляра.Gets the cache synchronization date for this instance.

Level

Возвращает значение HttpRequestCacheLevel, заданное при создании экземпляра.Gets the HttpRequestCacheLevel value that was specified when this instance was created.

MaxAge

Возвращает максимальное время существования, которое разрешено для ресурса, получаемого из кэша.Gets the maximum age permitted for a resource returned from the cache.

MaxStale

Возвращает максимальное значение устаревания, которое разрешено для ресурса, получаемого из кэша.Gets the maximum staleness value that is permitted for a resource returned from the cache.

MinFresh

Возвращает минимальное значение актуальности, которое разрешено для ресурса, получаемого из кэша.Gets the minimum freshness that is permitted for a resource returned from the cache.

Методы

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строковое представление данного экземпляра.Returns a string representation of this instance.

Применяется к

Дополнительно