HttpRequestCachePolicy Constructores

Definición

Espacio de nombres:

System.Net.Cache

Ensamblados:

netstandard.dll, System.Net.Requests.dll

Inicializa una nueva instancia de la clase HttpRequestCachePolicy.

Sobrecargas

Nombre	Description
HttpRequestCachePolicy()	Inicializa una nueva instancia de la clase HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)	Inicializa una nueva instancia de la HttpRequestCachePolicy clase utilizando la fecha de sincronización de caché especificada.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Inicializa una nueva instancia de la HttpRequestCachePolicy clase mediante la directiva de caché especificada.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Inicializa una nueva instancia de la HttpRequestCachePolicy clase utilizando el control de antigüedad y los valores de hora especificados.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Inicializa una nueva instancia de la HttpRequestCachePolicy clase utilizando la antigüedad máxima, el valor de control de edad y el valor de hora especificados.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Inicializa una nueva instancia de la HttpRequestCachePolicy clase con la antigüedad máxima, el valor de control de edad, el valor de hora y la fecha de sincronización de caché especificados.

HttpRequestCachePolicy()

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.

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 Level propiedad en Default.

HttpRequestCachePolicy(DateTime)

Source:

HttpRequestCachePolicy.cs

Inicializa una nueva instancia de la HttpRequestCachePolicy clase 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 la hora en que se deben volver a validar los recursos almacenados en la memoria 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é.

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é permite especificar una fecha absoluta cuando se debe volver a validar el contenido almacenado 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 revalidó después de la fecha de sincronización de caché y no hay ningún requisito de revalidación del servidor que haga que la entrada almacenada en caché no sea válida, se usará la entrada de la memoria caché. Si la fecha de sincronización de caché se establece en una fecha futura, la entrada se vuelve a validar cada vez que se solicita, hasta que se supere la fecha de sincronización de caché.

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

HttpRequestCachePolicy(HttpRequestCacheLevel)

Source:

HttpRequestCachePolicy.cs

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

Un HttpRequestCacheLevel valor.

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é.

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

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

Comentarios

Este constructor inicializa la Level propiedad en level.

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

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Source:

HttpRequestCachePolicy.cs

Inicializa una nueva instancia de la HttpRequestCachePolicy clase utilizando el control de antigüedad y los valores de hora 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 HttpCacheAgeControl valores de enumeración: MaxAge, MaxStaleo MinFresh.

ageOrFreshOrStale

TimeSpan

Valor TimeSpan que especifica una cantidad de tiempo.

Excepciones

ArgumentException

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

Ejemplos

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

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 Level propiedad en Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Source:

HttpRequestCachePolicy.cs

Inicializa una nueva instancia de la HttpRequestCachePolicy clase utilizando la antigüedad máxima, el valor de control de edad y el valor de hora 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

Un HttpCacheAgeControl valor.

maxAge

TimeSpan

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

freshOrStale

TimeSpan

Valor TimeSpan que especifica una cantidad 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é en función de la actualización mínima y la antigüedad máxima.

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 Level propiedad en Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Source:

HttpRequestCachePolicy.cs

Inicializa una nueva instancia de la HttpRequestCachePolicy clase con la antigüedad máxima, el valor de control de edad, el valor de hora 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

Un HttpCacheAgeControl valor.

maxAge

TimeSpan

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

freshOrStale

TimeSpan

Valor TimeSpan que especifica una cantidad de tiempo.

cacheSyncDate

DateTime

Objeto DateTime que especifica la hora en que se deben volver a validar los recursos almacenados en la memoria caché.

Ejemplos

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

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.