HttpRequestCachePolicy Construtores

Definição

Espaço de Nomes:

System.Net.Cache

Assemblagens:

netstandard.dll, System.Net.Requests.dll

Inicializa uma nova instância da HttpRequestCachePolicy classe.

Sobrecargas

Name	Descrição
HttpRequestCachePolicy()	Inicializa uma nova instância da HttpRequestCachePolicy classe.
HttpRequestCachePolicy(DateTime)	Inicializa uma nova instância da HttpRequestCachePolicy classe usando a data especificada de sincronização da cache.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Inicializa uma nova instância da HttpRequestCachePolicy classe usando a política de cache especificada.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Inicializa uma nova instância da HttpRequestCachePolicy classe usando os valores especificados de controlo de idade e tempo.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Inicializa uma nova instância da HttpRequestCachePolicy classe usando a idade máxima especificada, valor de controlo de idade e valor temporal.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Inicializa uma nova instância da HttpRequestCachePolicy classe usando a idade máxima especificada, valor de controlo de idade, valor temporal e data de sincronização da cache.

HttpRequestCachePolicy()

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da HttpRequestCachePolicy classe.

public:
 HttpRequestCachePolicy();

public HttpRequestCachePolicy();

Public Sub New ()

Exemplos

O seguinte exemplo de código demonstra como definir a política de cache usando este construtor.

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;
}

Observações

Este construtor inicializa a Level propriedade em Default.

HttpRequestCachePolicy(DateTime)

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da HttpRequestCachePolicy classe usando a data especificada de sincronização da cache.

public:
 HttpRequestCachePolicy(DateTime cacheSyncDate);

public HttpRequestCachePolicy(DateTime cacheSyncDate);

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

Public Sub New (cacheSyncDate As DateTime)

Parâmetros

cacheSyncDate

DateTime

Um DateTime objeto que especifica o momento em que os recursos armazenados na cache devem ser revalidados.

Exemplos

O exemplo de código seguinte demonstra a criação de uma política de cache baseada numa data de sincronização de cache.

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

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

Observações

A data de sincronização do cache permite especificar uma data absoluta em que o conteúdo armazenado em cache deve ser revalidado. Se a entrada da cache foi revalidada pela última vez antes da data de sincronização da cache, ocorre a revalidação com o servidor. Se a entrada da cache foi revalidada após a data de sincronização da cache e não existirem requisitos de revalidação do servidor que tornem a entrada em cache inválida, a entrada da cache é utilizada. Se a data de sincronização do cache for definida para uma data futura, a entrada será revalidada sempre que for solicitada, até que a data de sincronização do cache passe.

Este construtor inicializa a Level propriedade em Default. A CacheSyncDate propriedade é inicializada em cacheSyncDate.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da HttpRequestCachePolicy classe usando a política de cache especificada.

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)

Parâmetros

level

HttpRequestCacheLevel

Um HttpRequestCacheLevel valor.

Exemplos

O exemplo de código seguinte demonstra a criação de uma política de cache que permite que recursos encontrados na cache sejam usados a partir da cache.

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

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

Observações

Este construtor inicializa a Level propriedade em level.

O HttpRequestCacheLevel valor controla se a cache está ativada e quando a cache pode ser utilizada. Para informações adicionais, consulte a HttpRequestCacheLevel documentação.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da HttpRequestCachePolicy classe usando os valores especificados de controlo de idade e tempo.

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)

Parâmetros

cacheAgeControl

HttpCacheAgeControl

Um dos seguintes HttpCacheAgeControl valores de enumeração: MaxAge, MaxStale, ou MinFresh.

ageOrFreshOrStale

TimeSpan

Um valor que especifica TimeSpan uma quantidade de tempo.

Exceções

ArgumentException

O valor especificado para o cacheAgeControl parâmetro não pode ser usado com este construtor.

Exemplos

O exemplo de código seguinte demonstra a criação de uma política de cache baseada na frescura mínima.

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

Observações

O cacheAgeControl valor define o significado do valor do ageOrFreshOrStale parâmetro e é usado para definir a propriedade associada. Por exemplo, quando especifica MaxStale, a MaxStale propriedade é definida para o valor do ageOrFreshOrStale parâmetro.

Este construtor inicializa a Level propriedade em Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da HttpRequestCachePolicy classe usando a idade máxima especificada, valor de controlo de idade e valor temporal.

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)

Parâmetros

cacheAgeControl

HttpCacheAgeControl

Um HttpCacheAgeControl valor.

maxAge

TimeSpan

Um TimeSpan valor que especifica a idade máxima dos recursos.

freshOrStale

TimeSpan

Um valor que especifica TimeSpan uma quantidade de tempo.

Exceções

ArgumentException

O valor especificado para o parâmetro cacheAgeControl não é válido.

Exemplos

O exemplo de código seguinte demonstra a criação de uma política de cache baseada na frescura mínima e na idade máxima.

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

Observações

O cacheAgeControl valor é usado para interpretar o significado do valor do freshOrStale parâmetro e definir a propriedade associada. Por exemplo, quando especifica MaxStale, a MaxStale propriedade é definida para o valor do freshOrStale parâmetro. Quando especificas MaxAgeAndMaxStale, a MaxAge propriedade é definida usando o maxAge valor do parâmetro e a MaxStale propriedade é definida usando o valor do freshOrStale parâmetro.

Note que, a menos que especifique MaxAgeAndMaxStale ou MaxAgeAndMinFresh, a MaxAge propriedade não está definida.

Este construtor inicializa a Level propriedade em Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da HttpRequestCachePolicy classe usando a idade máxima especificada, valor de controlo de idade, valor temporal e data de sincronização da cache.

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)

Parâmetros

cacheAgeControl

HttpCacheAgeControl

Um HttpCacheAgeControl valor.

maxAge

TimeSpan

Um TimeSpan valor que especifica a idade máxima dos recursos.

freshOrStale

TimeSpan

Um valor que especifica TimeSpan uma quantidade de tempo.

cacheSyncDate

DateTime

Um DateTime objeto que especifica o momento em que os recursos armazenados na cache devem ser revalidados.

Exemplos

O exemplo de código seguinte demonstra a criação de uma política de cache baseada na frescura mínima, idade máxima e uma data de sincronização de cache.

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
}

Observações

O cacheAgeControl valor é usado para interpretar o significado do valor do freshOrStale parâmetro e definir a propriedade associada. Por exemplo, quando especifica MaxStale, a MaxStale propriedade é definida para o valor do freshOrStale parâmetro. Quando especificas MaxAgeAndMaxStale, a MaxAge propriedade é definida usando o maxAge valor do parâmetro e a MaxStale propriedade é definida usando o valor do freshOrStale parâmetro.

Note que, a menos que especifique MaxAgeAndMaxStale ou MaxAgeAndMinFresh, a MaxAge propriedade não está definida.

Este construtor inicializa a CacheSyncDate propriedade para cacheSyncDate, e inicializa a Level propriedade para Default.