HttpRequestCachePolicy Classe

Définition

Définit les exigences de mise en cache d'une application pour des ressources obtenues à l'aide d'objets HttpWebRequest.Defines an application's caching requirements for resources obtained by using HttpWebRequest objects.

public ref class HttpRequestCachePolicy : System::Net::Cache::RequestCachePolicy
public class HttpRequestCachePolicy : System.Net.Cache.RequestCachePolicy
type HttpRequestCachePolicy = class
    inherit RequestCachePolicy
Public Class HttpRequestCachePolicy
Inherits RequestCachePolicy
Héritage
HttpRequestCachePolicy

Exemples

L’exemple de code suivant crée une stratégie de cache par défaut pour le domaine d’application et la remplace pour une demande.The following code example creates a default cache policy for the application domain, and overrides it for a request.

// The following method demonstrates overriding the
// caching policy for a request.
static WebResponse^ GetResponseNoCache( Uri^ uri )
{
   // Set a default policy level for the "http:" and "https" schemes.
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpRequestCacheLevel::Default );
   HttpWebRequest::DefaultCachePolicy = policy;

   // Create the request.
   WebRequest^ request = WebRequest::Create( uri );

   // Define a cache policy for this request only. 
   HttpRequestCachePolicy^ noCachePolicy = gcnew HttpRequestCachePolicy( HttpRequestCacheLevel::NoCacheNoStore );
   request->CachePolicy = noCachePolicy;
   WebResponse^ response = request->GetResponse();
   Console::WriteLine( L"IsFromCache? {0}", response->IsFromCache );
   
   return response;
}
// The following method demonstrates overriding the
// caching policy for a request.
public static WebResponse GetResponseNoCache(Uri uri)
{
    // Set a default policy level for the "http:" and "https" schemes.
    HttpRequestCachePolicy policy = new HttpRequestCachePolicy(HttpRequestCacheLevel.Default);
    HttpWebRequest.DefaultCachePolicy = policy;
    // Create the request.
    WebRequest request = WebRequest.Create(uri);
    // Define a cache policy for this request only. 
    HttpRequestCachePolicy noCachePolicy = new HttpRequestCachePolicy(HttpRequestCacheLevel.NoCacheNoStore);
    request.CachePolicy = noCachePolicy;
    WebResponse response = request.GetResponse();
    Console.WriteLine("IsFromCache? {0}", response.IsFromCache);            
    return response;
}

Remarques

Vous pouvez spécifier une stratégie de cache par défaut pour votre application à l’aide de la propriété DefaultCachePolicy ou des fichiers de configuration de l’application ou de l’ordinateur.You can specify a default cache policy for your application by using the DefaultCachePolicy property or the application or machine configuration files. Pour plus d’informations, consultez <requestCaching>, élément (paramètres réseau).For more information, see <requestCaching> Element (Network Settings).

Vous pouvez spécifier la stratégie de cache pour une demande individuelle à l’aide de la propriété CachePolicy.You can specify the cache policy for an individual request by using the CachePolicy property.

La mise en cache pour les services Web n’est pas prise en charge.Caching for Web services is not supported.

Constructeurs

HttpRequestCachePolicy()

Initialise une nouvelle instance de la classe HttpRequestCachePolicy.Initializes a new instance of the HttpRequestCachePolicy class.

HttpRequestCachePolicy(DateTime)

Initialise une nouvelle instance de la classe HttpRequestCachePolicy avec la date de synchronisation de cache spécifiée.Initializes a new instance of the HttpRequestCachePolicy class using the specified cache synchronization date.

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.Initializes a new instance of the HttpRequestCachePolicy class using the specified age control and time values.

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.Initializes a new instance of the HttpRequestCachePolicy class using the specified maximum age, age control value, and time value.

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.Initializes a new instance of the HttpRequestCachePolicy class using the specified maximum age, age control value, time value, and cache synchronization date.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Initialise une nouvelle instance de la classe HttpRequestCachePolicy avec la stratégie de cache spécifiée.Initializes a new instance of the HttpRequestCachePolicy class using the specified cache policy.

Propriétés

CacheSyncDate

Obtient la date de synchronisation du cache pour cette instance.Gets the cache synchronization date for this instance.

Level

Obtient la valeur HttpRequestCacheLevel qui a été spécifiée lors de la création de cette instance.Gets the HttpRequestCacheLevel value that was specified when this instance was created.

MaxAge

Obtient l'âge maximal autorisé pour une ressource retournée à partir du cache.Gets the maximum age permitted for a resource returned from the cache.

MaxStale

Obtient la valeur de péremption maximale qui est autorisée pour une ressource retournée à partir du cache.Gets the maximum staleness value that is permitted for a resource returned from the cache.

MinFresh

Obtient la nouveauté minimale qui est autorisée pour une ressource retournée à partir du cache.Gets the minimum freshness that is permitted for a resource returned from the cache.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une représentation sous forme de chaîne de cette instance.Returns a string representation of this instance.

S’applique à

Voir aussi