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

Определение

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

System.Net.Cache

Сборки:

netstandard.dll, System.Net.Requests.dll

Инициализирует новый экземпляр класса HttpRequestCachePolicy.

Перегрузки

Имя	Описание
HttpRequestCachePolicy()	Инициализирует новый экземпляр класса HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)	Инициализирует новый экземпляр класса с помощью указанной HttpRequestCachePolicy даты синхронизации кэша.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Инициализирует новый экземпляр класса с помощью указанной HttpRequestCachePolicy политики кэша.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Инициализирует новый экземпляр класса с помощью указанных значений HttpRequestCachePolicy управления возрастом и времени.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Инициализирует новый экземпляр класса с помощью указанного HttpRequestCachePolicy максимального возраста, значения управления возрастом и времени.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Инициализирует новый экземпляр класса с использованием указанного HttpRequestCachePolicy максимального возраста, значения управления возрастом, значения времени и даты синхронизации кэша.

HttpRequestCachePolicy()

Исходный код:

HttpRequestCachePolicy.cs

Инициализирует новый экземпляр класса HttpRequestCachePolicy.

public:
 HttpRequestCachePolicy();

public HttpRequestCachePolicy();

Public Sub New ()

Примеры

В следующем примере кода показана настройка политики кэша с помощью этого конструктора.

public static WebResponse GetResponseUsingCacheDefault(Uri uri)
{
    // Set  the default cache policy level for the "http:" scheme.
    RequestCachePolicy policy = new RequestCachePolicy();
    // Create the request.
    WebRequest request = WebRequest.Create(uri);
    request.CachePolicy = policy;
    WebResponse response = request.GetResponse();
    Console.WriteLine("Policy level is {0}.", policy.Level.ToString());
    Console.WriteLine("Is the response from the cache? {0}", response.IsFromCache);

    return response;
}

Комментарии

Этот конструктор инициализирует Level свойство Defaultв .

HttpRequestCachePolicy(DateTime)

Исходный код:

HttpRequestCachePolicy.cs

Инициализирует новый экземпляр класса с помощью указанной HttpRequestCachePolicy даты синхронизации кэша.

public:
 HttpRequestCachePolicy(DateTime cacheSyncDate);

public HttpRequestCachePolicy(DateTime cacheSyncDate);

new System.Net.Cache.HttpRequestCachePolicy : DateTime -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheSyncDate As DateTime)

Параметры

cacheSyncDate

DateTime

DateTime Объект, указывающий время, когда ресурсы, хранящиеся в кэше, должны быть обновлены.

Примеры

В следующем примере кода показано создание политики кэша на основе даты синхронизации кэша.

public static HttpRequestCachePolicy CreateLastSyncPolicy(DateTime when)
{
    HttpRequestCachePolicy policy =
       new HttpRequestCachePolicy(when);

    Console.WriteLine("When: {0}", when);
    Console.WriteLine(policy.CacheSyncDate.ToString());
    return policy;
}

Комментарии

Дата синхронизации кэша позволяет указать абсолютную дату, когда кэшированное содержимое должно быть обновлено. Если запись кэша была последней повторной до даты синхронизации кэша, происходит повторная проверка с сервером. Если запись кэша была обновлена после даты синхронизации кэша и отсутствуют требования к повторной сортировке сервера, которые делают кэшированную запись недопустимой, используется запись из кэша. Если дата синхронизации кэша задана в будущем, запись обновляется при каждом запросе, пока дата синхронизации кэша не будет пройдена.

Этот конструктор инициализирует Level свойство Defaultв . Свойство CacheSyncDate инициализируется в cacheSyncDate.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Исходный код:

HttpRequestCachePolicy.cs

Инициализирует новый экземпляр класса с помощью указанной HttpRequestCachePolicy политики кэша.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpRequestCacheLevel level);

public HttpRequestCachePolicy(System.Net.Cache.HttpRequestCacheLevel level);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpRequestCacheLevel -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (level As HttpRequestCacheLevel)

Параметры

level

HttpRequestCacheLevel

Ценность HttpRequestCacheLevel .

Примеры

В следующем примере кода показано создание политики кэша, которая позволяет ресурсам, найденным в кэше, использоваться из кэша.

public static HttpRequestCachePolicy CreateCacheIfAvailablePolicy()
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpRequestCacheLevel.CacheIfAvailable);

    Console.WriteLine(policy.ToString());
    return policy;
}

Комментарии

Этот конструктор инициализирует Level свойство levelв .

Значение HttpRequestCacheLevel определяет, включено ли кэширование и когда кэш можно использовать. Дополнительные сведения см. в HttpRequestCacheLevel документации.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Исходный код:

HttpRequestCachePolicy.cs

Инициализирует новый экземпляр класса с помощью указанных значений HttpRequestCachePolicy управления возрастом и времени.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpCacheAgeControl cacheAgeControl, TimeSpan ageOrFreshOrStale);

public HttpRequestCachePolicy(System.Net.Cache.HttpCacheAgeControl cacheAgeControl, TimeSpan ageOrFreshOrStale);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpCacheAgeControl * TimeSpan -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheAgeControl As HttpCacheAgeControl, ageOrFreshOrStale As TimeSpan)

Параметры

cacheAgeControl

HttpCacheAgeControl

Одно из следующих HttpCacheAgeControl значений перечисления: MaxAge, MaxStaleили MinFresh.

ageOrFreshOrStale

TimeSpan

TimeSpan Значение, указывающее время.

Исключения

ArgumentException

Значение, указанное cacheAgeControl для параметра, нельзя использовать с этим конструктором.

Примеры

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

public static HttpRequestCachePolicy CreateMinFreshPolicy(TimeSpan span)
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpCacheAgeControl.MinFresh, span);
    Console.WriteLine("Minimum freshness {0}", policy.MinFresh.ToString());
    return policy;
}

Комментарии

Значение cacheAgeControl определяет значение ageOrFreshOrStale значения параметра и используется для задания связанного свойства. Например, при указании MaxStaleMaxStale свойство задается значением ageOrFreshOrStale параметра.

Этот конструктор инициализирует Level свойство Defaultв .

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Исходный код:

HttpRequestCachePolicy.cs

Инициализирует новый экземпляр класса с помощью указанного HttpRequestCachePolicy максимального возраста, значения управления возрастом и времени.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale);

public HttpRequestCachePolicy(System.Net.Cache.HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpCacheAgeControl * TimeSpan * TimeSpan -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheAgeControl As HttpCacheAgeControl, maxAge As TimeSpan, freshOrStale As TimeSpan)

Параметры

cacheAgeControl

HttpCacheAgeControl

Ценность HttpCacheAgeControl .

maxAge

TimeSpan

TimeSpan Значение, указывающее максимальный возраст ресурсов.

freshOrStale

TimeSpan

TimeSpan Значение, указывающее время.

Исключения

ArgumentException

Для параметра cacheAgeControl указано недопустимое значение.

Примеры

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

public static HttpRequestCachePolicy CreateFreshAndAgePolicy(TimeSpan freshMinimum, TimeSpan ageMaximum)
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh, ageMaximum, freshMinimum);
    Console.WriteLine(policy.ToString());
    return policy;
}

Комментарии

Значение cacheAgeControl используется для интерпретации freshOrStale значения параметра и задания связанного свойства. Например, при указании MaxStaleMaxStale свойство задается значением freshOrStale параметра. При указании MaxAgeAndMaxStaleMaxAge свойство задается с помощью значения maxAge параметра, а MaxStale свойство задается с помощью значения freshOrStale параметра.

Обратите внимание, что если не указано MaxAgeAndMaxStale или MaxAgeAndMinFreshMaxAge свойство не задано.

Этот конструктор инициализирует Level свойство Defaultв .

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Исходный код:

HttpRequestCachePolicy.cs

Инициализирует новый экземпляр класса с использованием указанного HttpRequestCachePolicy максимального возраста, значения управления возрастом, значения времени и даты синхронизации кэша.

public:
 HttpRequestCachePolicy(System::Net::Cache::HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale, DateTime cacheSyncDate);

public HttpRequestCachePolicy(System.Net.Cache.HttpCacheAgeControl cacheAgeControl, TimeSpan maxAge, TimeSpan freshOrStale, DateTime cacheSyncDate);

new System.Net.Cache.HttpRequestCachePolicy : System.Net.Cache.HttpCacheAgeControl * TimeSpan * TimeSpan * DateTime -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheAgeControl As HttpCacheAgeControl, maxAge As TimeSpan, freshOrStale As TimeSpan, cacheSyncDate As DateTime)

Параметры

cacheAgeControl

HttpCacheAgeControl

Ценность HttpCacheAgeControl .

maxAge

TimeSpan

TimeSpan Значение, указывающее максимальный возраст ресурсов.

freshOrStale

TimeSpan

TimeSpan Значение, указывающее время.

cacheSyncDate

DateTime

DateTime Объект, указывающий время, когда ресурсы, хранящиеся в кэше, должны быть обновлены.

Примеры

В следующем примере кода показано создание политики кэша на основе минимальной свежести, максимального возраста и даты синхронизации кэша.

public static HttpRequestCachePolicy CreateFreshAndAgePolicy2(TimeSpan freshMinimum, TimeSpan ageMaximum, DateTime when)
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh, ageMaximum, freshMinimum, when);
    Console.WriteLine(policy.ToString());
    return policy;
    // For the following invocation:
    // CreateFreshAndAgePolicy(new TimeSpan(5,0,0), new TimeSpan(10,0,0),);
    // the output is:
    // Level:Automatic
    // AgeControl:MinFreshAndMaxAge
    // MinFresh:18000
    // MaxAge:36000
}

Комментарии

Значение cacheAgeControl используется для интерпретации freshOrStale значения параметра и задания связанного свойства. Например, при указании MaxStaleMaxStale свойство задается значением freshOrStale параметра. При указании MaxAgeAndMaxStaleMaxAge свойство задается с помощью значения maxAge параметра, а MaxStale свойство задается с помощью значения freshOrStale параметра.

Обратите внимание, что если не указано MaxAgeAndMaxStale или MaxAgeAndMinFreshMaxAge свойство не задано.

Этот конструктор инициализирует свойство в , и инициализирует CacheSyncDate свойство в Default.LevelcacheSyncDate