HttpRequestCachePolicy Construtores

Definição

Namespace:

System.Net.Cache

Assemblies:

netstandard.dll, System.Net.Requests.dll

Inicializa uma nova instância da classe HttpRequestCachePolicy.

Sobrecargas

Nome	Description
HttpRequestCachePolicy()	Inicializa uma nova instância da classe HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)	Inicializa uma nova instância da HttpRequestCachePolicy classe usando a data de sincronização de cache especificada.
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 de tempo e controle de idade especificados.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Inicializa uma nova instância da HttpRequestCachePolicy classe usando a idade máxima, o valor de controle de idade e o valor de tempo especificados.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Inicializa uma nova instância da HttpRequestCachePolicy classe usando a idade máxima, o valor de controle de idade, o valor de tempo e a data de sincronização do cache especificados.

HttpRequestCachePolicy()

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da classe HttpRequestCachePolicy.

public:
 HttpRequestCachePolicy();

public HttpRequestCachePolicy();

Public Sub New ()

Exemplos

O exemplo de código a seguir demonstra como definir a política de cache usando esse 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;
}

Comentários

Esse construtor inicializa a Level propriedade para Default.

HttpRequestCachePolicy(DateTime)

Origem:

HttpRequestCachePolicy.cs

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

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 a hora em que os recursos armazenados no cache devem ser revalidados.

Exemplos

O exemplo de código a seguir demonstra a criação de uma política de cache com base em uma 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;
}

Comentários

A data de sincronização de cache permite que você especifique uma data absoluta quando o conteúdo armazenado em cache deve ser revalidado. Se a entrada de cache tiver sido revalidada pela última vez antes da data de sincronização de cache, ocorrerá a revalidação com o servidor. Se a entrada de cache tiver sido revalidada após a data de sincronização do cache e não houver requisitos de revalidação de servidor que tornem a entrada armazenada em cache inválida, a entrada do cache será usada. Se a data de sincronização do cache for definida como uma data futura, a entrada será validada novamente sempre que for solicitada, até que a data de sincronização do cache passe.

Esse construtor inicializa a Level propriedade para Default. A CacheSyncDate propriedade é inicializada para 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 a seguir demonstra a criação de uma política de cache que permite que os recursos encontrados no cache sejam usados no cache.

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

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

Comentários

Esse construtor inicializa a Level propriedade para level.

O HttpRequestCacheLevel valor controla se o cache está habilitado e quando o cache pode ser usado. Para obter 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 de tempo e controle de idade especificados.

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, MaxStaleou MinFresh.

ageOrFreshOrStale

TimeSpan

Um TimeSpan valor que especifica uma quantidade de tempo.

Exceções

ArgumentException

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

Exemplos

O exemplo de código a seguir demonstra a criação de uma política de cache com base na atualização 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;
}

Comentários

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

Esse construtor inicializa a Level propriedade para Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da HttpRequestCachePolicy classe usando a idade máxima, o valor de controle de idade e o valor de tempo especificados.

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 TimeSpan valor que especifica 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 a seguir demonstra a criação de uma política de cache com base na atualização 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;
}

Comentários

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

Observe que, a menos que você especifique MaxAgeAndMaxStale ou MaxAgeAndMinFresha MaxAge propriedade não esteja definida.

Esse construtor inicializa a Level propriedade para Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da HttpRequestCachePolicy classe usando a idade máxima, o valor de controle de idade, o valor de tempo e a data de sincronização do cache especificados.

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 TimeSpan valor que especifica uma quantidade de tempo.

cacheSyncDate

DateTime

Um DateTime objeto que especifica a hora em que os recursos armazenados no cache devem ser revalidados.

Exemplos

O exemplo de código a seguir demonstra a criação de uma política de cache com base na atualização mínima, na idade máxima e em 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
}

Comentários

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

Observe que, a menos que você especifique MaxAgeAndMaxStale ou MaxAgeAndMinFresha MaxAge propriedade não esteja definida.

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