HttpRequestCachePolicy HttpRequestCachePolicy HttpRequestCachePolicy HttpRequestCachePolicy Class

Definition

Definiert die Zwischenspeicherungsanforderungen einer Anwendung für Ressourcen, die mithilfe von HttpWebRequest-Objekten abgerufen wurden.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
Vererbung
HttpRequestCachePolicyHttpRequestCachePolicyHttpRequestCachePolicyHttpRequestCachePolicy

Beispiele

Im folgenden Codebeispiel wird eine Standard Cache Richtlinie für die Anwendungsdomäne erstellt und für eine Anforderung überschrieben.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;
}

Hinweise

Sie können eine Standard Cache Richtlinie für Ihre Anwendung angeben, indem Sie DefaultCachePolicy die-Eigenschaft oder die Anwendungs-oder Computer Konfigurationsdateien verwenden.You can specify a default cache policy for your application by using the DefaultCachePolicy property or the application or machine configuration files. Weitere Informationen finden <Sie unter requestCaching> -Element (Netzwerkeinstellungen).For more information, see <requestCaching> Element (Network Settings).

Sie können die Cache Richtlinie für eine einzelne Anforderung mithilfe der CachePolicy -Eigenschaft angeben.You can specify the cache policy for an individual request by using the CachePolicy property.

Caching für Webdienste wird nicht unterstützt.Caching for Web services is not supported.

Konstruktoren

HttpRequestCachePolicy() HttpRequestCachePolicy() HttpRequestCachePolicy() HttpRequestCachePolicy()

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse.Initializes a new instance of the HttpRequestCachePolicy class.

HttpRequestCachePolicy(DateTime) HttpRequestCachePolicy(DateTime) HttpRequestCachePolicy(DateTime) HttpRequestCachePolicy(DateTime)

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse unter Verwendung des angegebenen Cachesynchronisierungsdatums.Initializes a new instance of the HttpRequestCachePolicy class using the specified cache synchronization date.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse mit den angegebenen Werten für Alterssteuerung und Zeit.Initializes a new instance of the HttpRequestCachePolicy class using the specified age control and time values.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse unter Verwendung der angegebenen Werte für maximales Alter, Alterssteuerung und Zeit.Initializes a new instance of the HttpRequestCachePolicy class using the specified maximum age, age control value, and time value.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime) HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse unter Verwendung der angegebenen Werte für maximales Alter, Alterssteuerung und Zeit sowie des angegebenen Cachesynchronisierungsdatums.Initializes a new instance of the HttpRequestCachePolicy class using the specified maximum age, age control value, time value, and cache synchronization date.

HttpRequestCachePolicy(HttpRequestCacheLevel) HttpRequestCachePolicy(HttpRequestCacheLevel) HttpRequestCachePolicy(HttpRequestCacheLevel) HttpRequestCachePolicy(HttpRequestCacheLevel)

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse unter Verwendung der angegebenen Cacherichtlinie.Initializes a new instance of the HttpRequestCachePolicy class using the specified cache policy.

Eigenschaften

CacheSyncDate CacheSyncDate CacheSyncDate CacheSyncDate

Ruft das Cachesynchronisierungsdatum für diese Instanz ab.Gets the cache synchronization date for this instance.

Level Level Level Level

Ruft den HttpRequestCacheLevel-Wert ab, der beim Erstellen dieser Instanz angegeben wurde.Gets the HttpRequestCacheLevel value that was specified when this instance was created.

MaxAge MaxAge MaxAge MaxAge

Ruft das maximal zulässige Alter für eine Ressource ab, die aus dem Cache zurückgegeben wird.Gets the maximum age permitted for a resource returned from the cache.

MaxStale MaxStale MaxStale MaxStale

Ruft den maximal zulässigen Wert für die Veralterung einer Ressource ab, die aus dem Cache zurückgegeben wird.Gets the maximum staleness value that is permitted for a resource returned from the cache.

MinFresh MinFresh MinFresh MinFresh

Ruft die minimal zulässige Aktualität für eine Ressource ab, die aus dem Cache zurückgegeben wird.Gets the minimum freshness that is permitted for a resource returned from the cache.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolgenentsprechung dieser Instanz zurück.Returns a string representation of this instance.

Gilt für:

Siehe auch