HttpRequestCachePolicy Klasse

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
HttpRequestCachePolicy

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()

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

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)

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)

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)

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)

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

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

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

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

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

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)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

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

(Geerbt von Object)
MemberwiseClone()

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

(Geerbt von Object)
ToString()

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

Gilt für:

Siehe auch