Comparteix a través de

HttpRequestCachePolicy Constructores

  • Referencia

Definición

Espacio de nombres:
System.Net.Cache
Ensamblado:
System.Net.Requests.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll

Inicializa una nueva instancia de la clase HttpRequestCachePolicy.

Sobrecargas

HttpRequestCachePolicy()

Inicializa una nueva instancia de la clase HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)

Inicializa una instancia nueva de la clase HttpRequestCachePolicy utilizando la fecha de sincronización de caché especificada.
HttpRequestCachePolicy(HttpRequestCacheLevel)

Inicializa una instancia nueva de la clase HttpRequestCachePolicy mediante la directiva de caché especificada.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Inicializa una instancia nueva de la clase HttpRequestCachePolicy con los valores del control de edad y de tiempo especificados.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Inicializa una instancia nueva de la clase HttpRequestCachePolicy utilizando la edad máxima especificada, el valor de control de edad y el valor de tiempo.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Inicializa una instancia nueva de la clase HttpRequestCachePolicy utilizando la edad máxima, el valor de control de edad, el valor de tiempo y la fecha de sincronización de caché especificados.

HttpRequestCachePolicy()

Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs

Inicializa una nueva instancia de la clase HttpRequestCachePolicy.

public:
 HttpRequestCachePolicy();
public HttpRequestCachePolicy ();
Public Sub New ()

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la directiva de caché mediante este constructor.

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

Comentarios

Este constructor inicializa la propiedad Level en Default.

Se aplica a

HttpRequestCachePolicy(DateTime)

Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs

Inicializa una instancia nueva de la clase HttpRequestCachePolicy utilizando la fecha de sincronización de caché 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

Objeto DateTime que especifica cuándo se deben volver a validar los recursos almacenados en caché.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una directiva de caché basada en una fecha de sincronización de caché.

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

Comentarios

La fecha de sincronización de caché le permite especificar una fecha absoluta en la que se debe volver a validar el contenido en caché. Si la entrada de caché se revalidó por última vez antes de la fecha de sincronización de caché, se produce la revalidación con el servidor. Si la entrada de caché se revalida después de la fecha de sincronización de caché y no hay requisitos de revalidación del servidor que hacen que la entrada almacenada en caché no sea válida, se usa la entrada de la memoria caché. Si la fecha de sincronización de caché se establece en una fecha futura, la entrada se volverá a validar cada vez que se solicite, hasta que haya pasado la fecha de sincronización de caché.

Este constructor inicializa la propiedad Level en Default. La propiedad CacheSyncDate se inicializa en cacheSyncDate.

Se aplica a

HttpRequestCachePolicy(HttpRequestCacheLevel)

Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs

Inicializa una instancia nueva de la clase HttpRequestCachePolicy mediante la directiva de caché 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

Valor HttpRequestCacheLevel.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una directiva de caché que permite usar los recursos que se encuentran en la memoria caché desde la memoria caché.

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

Comentarios

Este constructor inicializa la propiedad Level en level.

El HttpRequestCacheLevel valor controla si el almacenamiento en caché está habilitado y cuándo se puede usar la memoria caché. Para más información, consulte la HttpRequestCacheLevel documentación.

Se aplica a

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs

Inicializa una instancia nueva de la clase HttpRequestCachePolicy con los valores del control de edad y de tiempo 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

Uno de los siguientes valores de la enumeración HttpCacheAgeControl: MaxAge, MaxStale o MinFresh.

ageOrFreshOrStale
TimeSpan

Valor de TimeSpan que especifica un período de tiempo.

Excepciones

ArgumentException

El valor especificado para el parámetro cacheAgeControl no se puede utilizar con este constructor.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una directiva de caché basada en la actualización 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;
}

Comentarios

El cacheAgeControl valor define el significado del valor del ageOrFreshOrStale parámetro y se usa para establecer la propiedad asociada. Por ejemplo, al especificar MaxStale, la MaxStale propiedad se establece en el valor del ageOrFreshOrStale parámetro .

Este constructor inicializa la propiedad Level en Default.

Se aplica a

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs

Inicializa una instancia nueva de la clase HttpRequestCachePolicy utilizando la edad máxima especificada, el valor de control de edad y el valor de tiempo.

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

Valor HttpCacheAgeControl.

maxAge
TimeSpan

Valor de TimeSpan que especifica la edad máxima de los recursos.

freshOrStale
TimeSpan

Valor de TimeSpan que especifica un período de tiempo.

Excepciones

ArgumentException

El valor especificado para el parámetro cacheAgeControl no es válido.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una directiva de caché basada en la actualización mínima y la antigüedad 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;
}

Comentarios

El cacheAgeControl valor se usa para interpretar el significado del valor del freshOrStale parámetro y establecer la propiedad asociada. Por ejemplo, al especificar MaxStale, la MaxStale propiedad se establece en el valor del freshOrStale parámetro . Cuando se especifica MaxAgeAndMaxStale, la MaxAge propiedad se establece mediante el valor del maxAge parámetro y la MaxStale propiedad se establece mediante el valor del freshOrStale parámetro .

Tenga en cuenta que, a menos que especifique MaxAgeAndMaxStale o MaxAgeAndMinFresh, la MaxAge propiedad no está establecida.

Este constructor inicializa la propiedad Level en Default.

Se aplica a

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs
Source:
HttpRequestCachePolicy.cs

Inicializa una instancia nueva de la clase HttpRequestCachePolicy utilizando la edad máxima, el valor de control de edad, el valor de tiempo y la fecha de sincronización de caché 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

Valor HttpCacheAgeControl.

maxAge
TimeSpan

Valor de TimeSpan que especifica la edad máxima de los recursos.

freshOrStale
TimeSpan

Valor de TimeSpan que especifica un período de tiempo.

cacheSyncDate
DateTime

Objeto DateTime que especifica cuándo se deben volver a validar los recursos almacenados en caché.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear una directiva de caché basada en la actualización mínima, la antigüedad máxima y una fecha de sincronización de caché.

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
}

Comentarios

El cacheAgeControl valor se usa para interpretar el significado del valor del freshOrStale parámetro y establecer la propiedad asociada. Por ejemplo, al especificar MaxStale, la MaxStale propiedad se establece en el valor del freshOrStale parámetro . Cuando se especifica MaxAgeAndMaxStale, la MaxAge propiedad se establece mediante el valor del maxAge parámetro y la MaxStale propiedad se establece mediante el valor del freshOrStale parámetro .

Tenga en cuenta que, a menos que especifique MaxAgeAndMaxStale o MaxAgeAndMinFresh, la MaxAge propiedad no está establecida.

Este constructor inicializa la CacheSyncDate propiedad cacheSyncDateen e inicializa la Level propiedad en Default.

Se aplica a