HttpRequestCachePolicy Construtores

Definição

Namespace:

System.Net.Cache

Assembly:

System.Net.Requests.dll

Inicializa uma nova instância da classe HttpRequestCachePolicy.

Sobrecargas

HttpRequestCachePolicy()	Inicializa uma nova instância da classe HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)	Inicializa uma nova instância da classe HttpRequestCachePolicy usando a data de sincronização de cache especificada.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Inicializa uma nova instância da classe HttpRequestCachePolicy usando a política de cache especificada.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Inicializa uma nova instância da classe HttpRequestCachePolicy usando os valores temporais e de controle de idade especificados.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Inicializa uma nova instância da classe HttpRequestCachePolicy usando o valor temporal, o valor de controle de idade e o valor de idade máxima especificados.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Inicializa uma nova instância da classe HttpRequestCachePolicy usando o valor temporal, o valor de controle de idade, o valor de idade máxima e a data de sincronização de 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.

static WebResponse^ GetResponseUsingCacheDefault( Uri^ uri )
{
   // Set  the default cache policy level for the "http:" scheme.
   RequestCachePolicy^ policy = gcnew RequestCachePolicy;

   // Create the request.
   WebRequest^ request = WebRequest::Create( uri );
   request->CachePolicy = policy;
   WebResponse^ response = request->GetResponse();
   Console::WriteLine( L"Policy level is {0}.", policy->Level );
   Console::WriteLine( L"Is the response from the cache? {0}", response->IsFromCache );
   return response;
}

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 como Default.

HttpRequestCachePolicy(DateTime)

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da classe HttpRequestCachePolicy 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 objeto DateTime que especifica a hora em que os recursos armazenados em 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.

static HttpRequestCachePolicy^ CreateLastSyncPolicy( DateTime when )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( when );
   Console::WriteLine( L"When: {0}", when );
   Console::WriteLine( policy->CacheSyncDate );
   return policy;
}

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 do cache permite especificar 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 do 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 inválida a entrada armazenada em cache, a entrada do cache será usada. Se a data de sincronização do cache for definida como uma data futura, a entrada será revalidada sempre que solicitado, até que a data de sincronização do cache tenha decorrido.

Esse construtor inicializa a Level propriedade como Default. A propriedade CacheSyncDate é inicializada com cacheSyncDate.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da classe HttpRequestCachePolicy 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 valor HttpRequestCacheLevel.

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.

static HttpRequestCachePolicy^ CreateCacheIfAvailablePolicy()
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpRequestCacheLevel::CacheIfAvailable );
   Console::WriteLine( policy );
   return policy;
}

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

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

Comentários

Esse construtor inicializa a Level propriedade como 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 classe HttpRequestCachePolicy usando os valores temporais e de 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 valores de enumeração de HttpCacheAgeControl: MaxAge, MaxStale ou MinFresh.

ageOrFreshOrStale

TimeSpan

Um valor de TimeSpan que especifica um período de tempo.

Exceções

ArgumentException

O valor especificado para o parâmetro cacheAgeControl não pode ser usado com este 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.

static HttpRequestCachePolicy^ CreateMinFreshPolicy( TimeSpan span )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MinFresh,span );
   Console::WriteLine( L"Minimum freshness {0}", policy->MinFresh );
   return policy;
}

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 como Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da classe HttpRequestCachePolicy usando o valor temporal, o valor de controle de idade e o valor de idade máxima 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 valor HttpCacheAgeControl.

maxAge

TimeSpan

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

freshOrStale

TimeSpan

Um valor de TimeSpan que especifica um período 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.

static HttpRequestCachePolicy^ CreateFreshAndAgePolicy( TimeSpan freshMinimum, TimeSpan ageMaximum )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MaxAgeAndMinFresh,
       ageMaximum, freshMinimum );
   Console::WriteLine( policy );
   return policy;
}

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 MaxAgeAndMinFresh, a MaxAge propriedade não está definida.

Esse construtor inicializa a Level propriedade como Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Origem:

HttpRequestCachePolicy.cs

Inicializa uma nova instância da classe HttpRequestCachePolicy usando o valor temporal, o valor de controle de idade, o valor de idade máxima e a data de sincronização de 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 valor HttpCacheAgeControl.

maxAge

TimeSpan

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

freshOrStale

TimeSpan

Um valor de TimeSpan que especifica um período de tempo.

cacheSyncDate

DateTime

Um objeto DateTime que especifica a hora em que os recursos armazenados em 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, idade máxima e uma data de sincronização de cache.

static HttpRequestCachePolicy^ CreateFreshAndAgePolicy2( TimeSpan freshMinimum, TimeSpan ageMaximum, DateTime when )
{
   HttpRequestCachePolicy^ policy = 
       gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MaxAgeAndMinFresh, 
       ageMaximum, freshMinimum, when );
   Console::WriteLine( policy );
   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
}

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 MaxAgeAndMinFresh, a MaxAge propriedade não está definida.

Esse construtor inicializa a CacheSyncDate propriedade para cacheSyncDatee inicializa a Level propriedade como Default.