HttpRequestCachePolicy Konstruktoren

Definition

Namespace:

System.Net.Cache

Assemblys:

netstandard.dll, System.Net.Requests.dll

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse.

Überlädt

Name	Beschreibung
HttpRequestCachePolicy()	Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse.
HttpRequestCachePolicy(DateTime)	Initialisiert eine neue Instanz der HttpRequestCachePolicy Klasse mithilfe des angegebenen Cachesynchronisierungsdatums.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Initialisiert eine neue Instanz der Klasse mithilfe der HttpRequestCachePolicy angegebenen Cacherichtlinie.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Initialisiert eine neue Instanz der HttpRequestCachePolicy Klasse mit den angegebenen Alters- und Zeitwerten.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Initialisiert eine neue Instanz der HttpRequestCachePolicy Klasse mithilfe des angegebenen Alters, des Alterssteuerungswerts und des Zeitwerts.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Initialisiert eine neue Instanz der HttpRequestCachePolicy Klasse mithilfe des angegebenen Alters, des Alterssteuerungswerts, des Zeitwerts und des Cachesynchronisierungsdatums.

HttpRequestCachePolicy()

Quelle:

HttpRequestCachePolicy.cs

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse.

public:
 HttpRequestCachePolicy();

public HttpRequestCachePolicy();

Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird das Festlegen der Cacherichtlinie mithilfe dieses Konstruktors veranschaulicht.

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

Hinweise

Dieser Konstruktor initialisiert die Level Eigenschaft in Default.

HttpRequestCachePolicy(DateTime)

Quelle:

HttpRequestCachePolicy.cs

Initialisiert eine neue Instanz der HttpRequestCachePolicy Klasse mithilfe des angegebenen Cachesynchronisierungsdatums.

public:
 HttpRequestCachePolicy(DateTime cacheSyncDate);

public HttpRequestCachePolicy(DateTime cacheSyncDate);

new System.Net.Cache.HttpRequestCachePolicy : DateTime -> System.Net.Cache.HttpRequestCachePolicy

Public Sub New (cacheSyncDate As DateTime)

Parameter

cacheSyncDate

DateTime

Ein DateTime Objekt, das die Zeit angibt, zu der Ressourcen, die im Cache gespeichert sind, neu überprüft werden müssen.

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen einer Cacherichtlinie basierend auf einem Cachesynchronisierungsdatum.

public static HttpRequestCachePolicy CreateLastSyncPolicy(DateTime when)
{
    HttpRequestCachePolicy policy =
       new HttpRequestCachePolicy(when);

    Console.WriteLine("When: {0}", when);
    Console.WriteLine(policy.CacheSyncDate.ToString());
    return policy;
}

Hinweise

Mit dem Cachesynchronisierungsdatum können Sie ein absolutes Datum angeben, an dem zwischengespeicherte Inhalte neu überprüft werden müssen. Wenn der Cacheeintrag vor dem Cachesynchronisierungsdatum zuletzt erneut überprüft wurde, tritt eine erneute Überprüfung mit dem Server auf. Wenn der Cacheeintrag nach dem Datum der Cachesynchronisierung erneut überprüft wurde und keine Servervalidierungsanforderungen vorhanden sind, die den zwischengespeicherten Eintrag ungültig machen, wird der Eintrag aus dem Cache verwendet. Wenn das Datum der Cachesynchronisierung auf ein zukünftiges Datum festgelegt ist, wird der Eintrag bei jeder Anforderung neu überprüft, bis das Datum der Cachesynchronisierung vergangen ist.

Dieser Konstruktor initialisiert die Level Eigenschaft in Default. Die CacheSyncDate-Eigenschaft wird mit cacheSyncDate initialisiert.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Quelle:

HttpRequestCachePolicy.cs

Initialisiert eine neue Instanz der Klasse mithilfe der HttpRequestCachePolicy angegebenen Cacherichtlinie.

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)

Parameter

level

HttpRequestCacheLevel

Ein Wert HttpRequestCacheLevel .

Beispiele

Im folgenden Codebeispiel wird das Erstellen einer Cacherichtlinie veranschaulicht, mit der Ressourcen im Cache aus dem Cache verwendet werden können.

public static HttpRequestCachePolicy CreateCacheIfAvailablePolicy()
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpRequestCacheLevel.CacheIfAvailable);

    Console.WriteLine(policy.ToString());
    return policy;
}

Hinweise

Dieser Konstruktor initialisiert die Level Eigenschaft in level.

Der HttpRequestCacheLevel Wert steuert, ob die Zwischenspeicherung aktiviert ist und wann der Cache verwendet werden kann. Weitere Informationen finden Sie in der HttpRequestCacheLevel Dokumentation.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Quelle:

HttpRequestCachePolicy.cs

Initialisiert eine neue Instanz der HttpRequestCachePolicy Klasse mit den angegebenen Alters- und Zeitwerten.

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)

Parameter

cacheAgeControl

HttpCacheAgeControl

Einer der folgenden HttpCacheAgeControl Enumerationswerte: MaxAge, , MaxStaleoder MinFresh.

ageOrFreshOrStale

TimeSpan

Ein TimeSpan Wert, der eine Zeitspanne angibt.

Ausnahmen

ArgumentException

Der für den cacheAgeControl Parameter angegebene Wert kann nicht mit diesem Konstruktor verwendet werden.

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen einer Cacherichtlinie basierend auf minimaler Aktualität.

public static HttpRequestCachePolicy CreateMinFreshPolicy(TimeSpan span)
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpCacheAgeControl.MinFresh, span);
    Console.WriteLine("Minimum freshness {0}", policy.MinFresh.ToString());
    return policy;
}

Hinweise

Der cacheAgeControl Wert definiert die Bedeutung des ageOrFreshOrStale Parameterwerts und wird verwendet, um die zugeordnete Eigenschaft festzulegen. Wenn Sie beispielsweise angeben MaxStale, wird die MaxStale Eigenschaft auf den Wert des ageOrFreshOrStale Parameters festgelegt.

Dieser Konstruktor initialisiert die Level Eigenschaft in Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Quelle:

HttpRequestCachePolicy.cs

Initialisiert eine neue Instanz der HttpRequestCachePolicy Klasse mithilfe des angegebenen Alters, des Alterssteuerungswerts und des Zeitwerts.

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)

Parameter

cacheAgeControl

HttpCacheAgeControl

Ein Wert HttpCacheAgeControl .

maxAge

TimeSpan

Ein TimeSpan Wert, der das maximale Alter für Ressourcen angibt.

freshOrStale

TimeSpan

Ein TimeSpan Wert, der eine Zeitspanne angibt.

Ausnahmen

ArgumentException

Der für den cacheAgeControl-Parameter angegebene Wert ist ungültig.

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen einer Cacherichtlinie basierend auf der mindesten Aktualität und dem maximalen Alter.

public static HttpRequestCachePolicy CreateFreshAndAgePolicy(TimeSpan freshMinimum, TimeSpan ageMaximum)
{
    HttpRequestCachePolicy policy =
        new HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh, ageMaximum, freshMinimum);
    Console.WriteLine(policy.ToString());
    return policy;
}

Hinweise

Der cacheAgeControl Wert wird verwendet, um die Bedeutung des freshOrStale Parameterwerts zu interpretieren und die zugeordnete Eigenschaft festzulegen. Wenn Sie beispielsweise angeben MaxStale, wird die MaxStale Eigenschaft auf den Wert des freshOrStale Parameters festgelegt. Wenn Sie angeben MaxAgeAndMaxStale, wird die MaxAge Eigenschaft mithilfe des Werts des maxAge Parameters festgelegt, und die MaxStale Eigenschaft wird mit dem Wert des freshOrStale Parameters festgelegt.

Beachten Sie, dass die Eigenschaft nicht festgelegt ist, es sei denn, Sie geben die Eigenschaft an MaxAgeAndMaxStale oder MaxAgeAndMinFreshlegen sie MaxAge fest.

Dieser Konstruktor initialisiert die Level Eigenschaft in Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Quelle:

HttpRequestCachePolicy.cs

Initialisiert eine neue Instanz der HttpRequestCachePolicy Klasse mithilfe des angegebenen Alters, des Alterssteuerungswerts, des Zeitwerts und des Cachesynchronisierungsdatums.

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)

Parameter

cacheAgeControl

HttpCacheAgeControl

Ein Wert HttpCacheAgeControl .

maxAge

TimeSpan

Ein TimeSpan Wert, der das maximale Alter für Ressourcen angibt.

freshOrStale

TimeSpan

Ein TimeSpan Wert, der eine Zeitspanne angibt.

cacheSyncDate

DateTime

Ein DateTime Objekt, das die Zeit angibt, zu der Ressourcen, die im Cache gespeichert sind, neu überprüft werden müssen.

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen einer Cacherichtlinie basierend auf minimaler Aktualität, maximalem Alter und einem Cachesynchronisierungsdatum.

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
}

Hinweise

Der cacheAgeControl Wert wird verwendet, um die Bedeutung des freshOrStale Parameterwerts zu interpretieren und die zugeordnete Eigenschaft festzulegen. Wenn Sie beispielsweise angeben MaxStale, wird die MaxStale Eigenschaft auf den Wert des freshOrStale Parameters festgelegt. Wenn Sie angeben MaxAgeAndMaxStale, wird die MaxAge Eigenschaft mithilfe des Werts des maxAge Parameters festgelegt, und die MaxStale Eigenschaft wird mit dem Wert des freshOrStale Parameters festgelegt.

Beachten Sie, dass die Eigenschaft nicht festgelegt ist, es sei denn, Sie geben die Eigenschaft an MaxAgeAndMaxStale oder MaxAgeAndMinFreshlegen sie MaxAge fest.

Dieser Konstruktor initialisiert die CacheSyncDate Eigenschaft in cacheSyncDate, und initialisiert die Level Eigenschaft in Default.