HttpRequestCachePolicy Класс

Определение

Пространство имен:

System.Net.Cache

Сборка:

System.Net.Requests.dll

Сборка:

System.dll

Сборка:

netstandard.dll

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

Политику кэша для отдельного запроса можно указать с помощью CachePolicy свойства.

Кэширование для веб-служб не поддерживается.

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

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()	Возвращает строковое представление данного экземпляра.

См. также раздел

• Управление кэшем для сетевых приложений