HttpRequestCachePolicy Constructeurs

Définition

Espace de noms:

System.Net.Cache

Assemblys:

netstandard.dll, System.Net.Requests.dll

Initialise une nouvelle instance de la classe HttpRequestCachePolicy.

Surcharges

Nom	Description
HttpRequestCachePolicy()	Initialise une nouvelle instance de la classe HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)	Initialise une nouvelle instance de la HttpRequestCachePolicy classe à l’aide de la date de synchronisation de cache spécifiée.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Initialise une nouvelle instance de la HttpRequestCachePolicy classe à l’aide de la stratégie de cache spécifiée.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Initialise une nouvelle instance de la HttpRequestCachePolicy classe à l’aide du contrôle d’âge et des valeurs de temps spécifiés.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Initialise une nouvelle instance de la HttpRequestCachePolicy classe à l’aide de l’âge maximal, de la valeur de contrôle d’âge et de la valeur de temps spécifiées.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Initialise une nouvelle instance de la HttpRequestCachePolicy classe à l’aide de l’âge maximal, de la valeur du contrôle d’âge, de la valeur de l’heure et de la date de synchronisation du cache spécifiées.

HttpRequestCachePolicy()

Source:

HttpRequestCachePolicy.cs

Initialise une nouvelle instance de la classe HttpRequestCachePolicy.

public:
 HttpRequestCachePolicy();

public HttpRequestCachePolicy();

Public Sub New ()

Exemples

L’exemple de code suivant illustre la définition de la stratégie de cache à l’aide de ce constructeur.

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

Remarques

Ce constructeur initialise la Level propriété sur Default.

HttpRequestCachePolicy(DateTime)

Source:

HttpRequestCachePolicy.cs

Initialise une nouvelle instance de la HttpRequestCachePolicy classe à l’aide de la date de synchronisation de cache spécifiée.

public:
 HttpRequestCachePolicy(DateTime cacheSyncDate);

public HttpRequestCachePolicy(DateTime cacheSyncDate);

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

Public Sub New (cacheSyncDate As DateTime)

Paramètres

cacheSyncDate

DateTime

Objet DateTime qui spécifie l’heure à laquelle les ressources stockées dans le cache doivent être revalidées.

Exemples

L’exemple de code suivant illustre la création d’une stratégie de cache basée sur une date de synchronisation 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;
}

Remarques

La date de synchronisation du cache vous permet de spécifier une date absolue lorsque le contenu mis en cache doit être revalidé. Si l’entrée du cache a été revalidée avant la date de synchronisation du cache, la revalidation avec le serveur se produit. Si l’entrée du cache a été revalidée après la date de synchronisation du cache et qu’il n’existe aucune configuration requise pour la revalidation du serveur qui rend l’entrée mise en cache non valide, l’entrée du cache est utilisée. Si la date de synchronisation du cache est définie sur une date ultérieure, l’entrée est revalidée chaque fois qu’elle est demandée, jusqu’à ce que la date de synchronisation du cache passe.

Ce constructeur initialise la Level propriété sur Default. La propriété CacheSyncDate est initialisée à cacheSyncDate.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Source:

HttpRequestCachePolicy.cs

Initialise une nouvelle instance de la HttpRequestCachePolicy classe à l’aide de la stratégie de cache spécifiée.

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)

Paramètres

level

HttpRequestCacheLevel

Une HttpRequestCacheLevel valeur.

Exemples

L’exemple de code suivant illustre la création d’une stratégie de cache qui permet aux ressources trouvées dans le cache d’être utilisées à partir du cache.

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

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

Remarques

Ce constructeur initialise la Level propriété sur level.

La HttpRequestCacheLevel valeur contrôle si la mise en cache est activée et quand le cache peut être utilisé. Pour plus d’informations, consultez la HttpRequestCacheLevel documentation.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Source:

HttpRequestCachePolicy.cs

Initialise une nouvelle instance de la HttpRequestCachePolicy classe à l’aide du contrôle d’âge et des valeurs de temps spécifiés.

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)

Paramètres

cacheAgeControl

HttpCacheAgeControl

Une des valeurs d’énumération suivantes HttpCacheAgeControl : MaxAge, MaxStaleou MinFresh.

ageOrFreshOrStale

TimeSpan

Valeur TimeSpan qui spécifie un délai.

Exceptions

ArgumentException

La valeur spécifiée pour le cacheAgeControl paramètre ne peut pas être utilisée avec ce constructeur.

Exemples

L’exemple de code suivant illustre la création d’une stratégie de cache basée sur une actualisation minimale.

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

Remarques

La cacheAgeControl valeur définit la signification de la ageOrFreshOrStale valeur du paramètre et est utilisée pour définir la propriété associée. Par exemple, lorsque vous spécifiez MaxStale, la MaxStale propriété est définie sur la valeur du ageOrFreshOrStale paramètre.

Ce constructeur initialise la Level propriété sur Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Source:

HttpRequestCachePolicy.cs

Initialise une nouvelle instance de la HttpRequestCachePolicy classe à l’aide de l’âge maximal, de la valeur de contrôle d’âge et de la valeur de temps spécifiées.

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)

Paramètres

cacheAgeControl

HttpCacheAgeControl

Une HttpCacheAgeControl valeur.

maxAge

TimeSpan

Valeur TimeSpan qui spécifie l’âge maximal des ressources.

freshOrStale

TimeSpan

Valeur TimeSpan qui spécifie un délai.

Exceptions

ArgumentException

La valeur spécifiée pour le paramètre cacheAgeControl n'est pas valide.

Exemples

L’exemple de code suivant illustre la création d’une stratégie de cache en fonction de l’actualisation minimale et de l’âge maximal.

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

Remarques

La cacheAgeControl valeur est utilisée pour interpréter la signification de la freshOrStale valeur du paramètre et définir la propriété associée. Par exemple, lorsque vous spécifiez MaxStale, la MaxStale propriété est définie sur la valeur du freshOrStale paramètre. Lorsque vous spécifiez MaxAgeAndMaxStale, la MaxAge propriété est définie à l’aide de la valeur du maxAge paramètre et la MaxStale propriété est définie à l’aide de la valeur du freshOrStale paramètre.

Notez que, sauf si vous spécifiez MaxAgeAndMaxStale ou MaxAgeAndMinFresh, la MaxAge propriété n’est pas définie.

Ce constructeur initialise la Level propriété sur Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Source:

HttpRequestCachePolicy.cs

Initialise une nouvelle instance de la HttpRequestCachePolicy classe à l’aide de l’âge maximal, de la valeur du contrôle d’âge, de la valeur de l’heure et de la date de synchronisation du cache spécifiées.

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)

Paramètres

cacheAgeControl

HttpCacheAgeControl

Une HttpCacheAgeControl valeur.

maxAge

TimeSpan

Valeur TimeSpan qui spécifie l’âge maximal des ressources.

freshOrStale

TimeSpan

Valeur TimeSpan qui spécifie un délai.

cacheSyncDate

DateTime

Objet DateTime qui spécifie l’heure à laquelle les ressources stockées dans le cache doivent être revalidées.

Exemples

L’exemple de code suivant illustre la création d’une stratégie de cache en fonction de la fraîcheur minimale, de l’âge maximal et d’une date de synchronisation du 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
}

Remarques

La cacheAgeControl valeur est utilisée pour interpréter la signification de la freshOrStale valeur du paramètre et définir la propriété associée. Par exemple, lorsque vous spécifiez MaxStale, la MaxStale propriété est définie sur la valeur du freshOrStale paramètre. Lorsque vous spécifiez MaxAgeAndMaxStale, la MaxAge propriété est définie à l’aide de la valeur du maxAge paramètre et la MaxStale propriété est définie à l’aide de la valeur du freshOrStale paramètre.

Notez que, sauf si vous spécifiez MaxAgeAndMaxStale ou MaxAgeAndMinFresh, la MaxAge propriété n’est pas définie.

Ce constructeur initialise la CacheSyncDate propriété et cacheSyncDateinitialise la Level propriété sur Default.