HttpRequestCachePolicy Constructeurs

Définition

Espace de noms:

System.Net.Cache

Assembly:

System.Net.Requests.dll

Initialise une nouvelle instance de la classe HttpRequestCachePolicy.

Surcharges

HttpRequestCachePolicy()	Initialise une nouvelle instance de la classe HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)	Initialise une nouvelle instance de la classe HttpRequestCachePolicy avec la date de synchronisation de cache spécifiée.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Initialise une nouvelle instance de la classe HttpRequestCachePolicy avec la stratégie de cache spécifiée.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Initialise une nouvelle instance de la classe HttpRequestCachePolicy en utilisant les valeurs de date et de contrôle d'âge spécifiées.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Initialise une nouvelle instance de la classe HttpRequestCachePolicy à l'aide de l'âge maximal, de la valeur de contrôle d'âge et de la valeur temporelle spécifiés.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Initialise une nouvelle instance de la classe HttpRequestCachePolicy à l'aide de l'âge maximal, de la valeur de contrôle d'âge, de la valeur temporelle et de la date de synchronisation du cache spécifiés.

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.

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

Remarques

Ce constructeur initialise la propriété Level à la valeur Default.

HttpRequestCachePolicy(DateTime)

Source:

HttpRequestCachePolicy.cs

Initialise une nouvelle instance de la classe HttpRequestCachePolicy avec 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 du 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;
}

Remarques

La date de synchronisation du cache vous permet de spécifier une date fixe à laquelle le contenu en cache doit être revalidé. Si l’entrée du cache a été revalidée pour la dernière fois 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’aucune exigence de revalidation du serveur ne 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 à une date ultérieure, l’entrée est revalidée à chaque nouvelle requête jusqu’à ce que la date de synchronisation du cache soit atteinte.

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

HttpRequestCachePolicy(HttpRequestCacheLevel)

Source:

HttpRequestCachePolicy.cs

Initialise une nouvelle instance de la classe HttpRequestCachePolicy avec 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

Valeur HttpRequestCacheLevel.

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.

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

Remarques

Ce constructeur initialise la propriété Level à la valeur 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 classe HttpRequestCachePolicy en utilisant les valeurs de date et de contrôle d'âge spécifiées.

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 HttpCacheAgeControl suivantes : MaxAge, MaxStale ou MinFresh.

ageOrFreshOrStale

TimeSpan

Valeur TimeSpan qui spécifie une durée.

Exceptions

ArgumentException

La valeur spécifiée pour le paramètre cacheAgeControl 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 l’actualisation minimale.

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

Remarques

La cacheAgeControl valeur définit la signification de la ageOrFreshOrStale valeur de 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 propriété Level à la valeur Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Source:

HttpRequestCachePolicy.cs

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

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

Valeur HttpCacheAgeControl.

maxAge

TimeSpan

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

freshOrStale

TimeSpan

Valeur TimeSpan qui spécifie une durée.

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 basée sur l’actualisation minimale et l’âge maximal.

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

Remarques

La cacheAgeControl valeur est utilisée pour interpréter la signification de la freshOrStale valeur de 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 maxAge valeur du 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 propriété Level à la valeur Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Source:

HttpRequestCachePolicy.cs

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

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

Valeur HttpCacheAgeControl.

maxAge

TimeSpan

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

freshOrStale

TimeSpan

Valeur TimeSpan qui spécifie une durée.

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 l’actualisation minimale, l’âge maximal et une date de synchronisation du 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
}

Remarques

La cacheAgeControl valeur est utilisée pour interpréter la signification de la freshOrStale valeur de 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 maxAge valeur du 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é sur cacheSyncDateet initialise la Level propriété sur Default.