HttpRequestCachePolicy Classe

Definizione

Definisce i requisiti di cache di un'applicazione per le risorse ottenute utilizzando gli oggetti 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
Ereditarietà
HttpRequestCachePolicy

Esempi

Nell'esempio di codice seguente vengono creati criteri di cache predefiniti per il dominio dell'applicazione, che vengono quindi sostituiti per una richiesta.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;
}

Commenti

È possibile specificare criteri di cache predefiniti per l'applicazione usando la DefaultCachePolicy proprietà o i file di configurazione dell'applicazione o del computer.You can specify a default cache policy for your application by using the DefaultCachePolicy property or the application or machine configuration files. Per ulteriori informazioni, vedere <elemento> requestCaching (impostazioni di rete).For more information, see <requestCaching> Element (Network Settings).

È possibile specificare i criteri di cache per una singola richiesta utilizzando la CachePolicy proprietà.You can specify the cache policy for an individual request by using the CachePolicy property.

La memorizzazione nella cache per i servizi Web non è supportata.Caching for Web services is not supported.

Costruttori

HttpRequestCachePolicy()

Inizializza una nuova istanza della classe HttpRequestCachePolicy.Initializes a new instance of the HttpRequestCachePolicy class.

HttpRequestCachePolicy(DateTime)

Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando la data di sincronizzazione della cache specificata.Initializes a new instance of the HttpRequestCachePolicy class using the specified cache synchronization date.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando i valori specificati di ora e controllo della durata.Initializes a new instance of the HttpRequestCachePolicy class using the specified age control and time values.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando la durata massima, il valore di controllo della durata e il valore di ora specificati.Initializes a new instance of the HttpRequestCachePolicy class using the specified maximum age, age control value, and time value.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando la durata massima, il valore di controllo della durata e la data di sincronizzazione della cache specificati.Initializes a new instance of the HttpRequestCachePolicy class using the specified maximum age, age control value, time value, and cache synchronization date.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Inizializza una nuova istanza della classe HttpRequestCachePolicy utilizzando i criteri di cache specificati.Initializes a new instance of the HttpRequestCachePolicy class using the specified cache policy.

Proprietà

CacheSyncDate

Ottiene la data di sincronizzazione della cache per questa istanza.Gets the cache synchronization date for this instance.

Level

Ottiene il valore HttpRequestCacheLevel specificato quando è stata creata questa istanza.Gets the HttpRequestCacheLevel value that was specified when this instance was created.

MaxAge

Ottiene la durata massima consentita per una risorsa restituita dalla cache.Gets the maximum age permitted for a resource returned from the cache.

MaxStale

Ottiene il valore di obsolescenza massima consentito per una risorsa restituita dalla cache.Gets the maximum staleness value that is permitted for a resource returned from the cache.

MinFresh

Ottiene la validità minima consentita per una risorsa restituita dalla cache.Gets the minimum freshness that is permitted for a resource returned from the cache.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una rappresentazione in forma di stringa di questa istanza.Returns a string representation of this instance.

Si applica a

Vedi anche