HttpRequestCachePolicy Konstruktoren

Definition

Namespace:

System.Net.Cache

Assembly:

System.Net.Requests.dll

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse.

Überlädt

HttpRequestCachePolicy()	Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse.
HttpRequestCachePolicy(DateTime)	Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse unter Verwendung des angegebenen Cachesynchronisierungsdatums.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse unter Verwendung der angegebenen Cacherichtlinie.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse mit den angegebenen Werten für Alterssteuerung und Zeit.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse unter Verwendung der angegebenen Werte für maximales Alter, Alterssteuerung und Zeit.
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.

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.

static WebResponse^ GetResponseUsingCacheDefault( Uri^ uri )
{
   // Set  the default cache policy level for the "http:" scheme.
   RequestCachePolicy^ policy = gcnew RequestCachePolicy;

   // Create the request.
   WebRequest^ request = WebRequest::Create( uri );
   request->CachePolicy = policy;
   WebResponse^ response = request->GetResponse();
   Console::WriteLine( L"Policy level is {0}.", policy->Level );
   Console::WriteLine( L"Is the response from the cache? {0}", response->IsFromCache );
   return response;
}

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 mit Default.

HttpRequestCachePolicy(DateTime)

Quelle:

HttpRequestCachePolicy.cs

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse unter Verwendung 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 den Zeitpunkt angibt, zu dem im Cache gespeicherte Ressourcen erneut überprüft werden müssen.

Beispiele

Im folgenden Codebeispiel wird das Erstellen einer Cacherichtlinie basierend auf einem Cachesynchronisierungsdatum veranschaulicht.

static HttpRequestCachePolicy^ CreateLastSyncPolicy( DateTime when )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( when );
   Console::WriteLine( L"When: {0}", when );
   Console::WriteLine( policy->CacheSyncDate );
   return policy;
}

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

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

Hinweise

Durch das Datum der Cachesynchronisierung können Sie ein absolutes Datum angeben, an dem die zwischengespeicherten Inhalte erneut überprüft werden müssen. Wenn der Cacheeintrag zuletzt vor dem Cachesynchronisierungsdatum erneut überprüft wurde, erfolgt eine erneute Überprüfung mit dem Server. Wenn der Cacheeintrag nach dem Cachesynchronisierungsdatum erneut überprüft wurde und keine Server-Neuüberprüfungsanforderungen vorliegen, die den zwischengespeicherten Eintrag ungültig machen, wird der Eintrag aus dem Cache verwendet. Wenn das Datum der Cachesynchronisierung auf ein Datum in der Zukunft festgelegt ist, wird der Eintrag bei jedem Aufruf erneut überprüft, bis das Datum der Cachesynchronisierung vorüber ist.

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

HttpRequestCachePolicy(HttpRequestCacheLevel)

Quelle:

HttpRequestCachePolicy.cs

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse unter Verwendung der 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 HttpRequestCacheLevel-Wert.

Beispiele

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

static HttpRequestCachePolicy^ CreateCacheIfAvailablePolicy()
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpRequestCacheLevel::CacheIfAvailable );
   Console::WriteLine( policy );
   return policy;
}

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

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

Hinweise

Dieser Konstruktor initialisiert die Level-Eigenschaft mit 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 Werten für Alterssteuerung und Zeit.

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, MaxStale oder 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

Im folgenden Codebeispiel wird das Erstellen einer Cacherichtlinie basierend auf der minimalen Aktualität veranschaulicht.

static HttpRequestCachePolicy^ CreateMinFreshPolicy( TimeSpan span )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MinFresh,span );
   Console::WriteLine( L"Minimum freshness {0}", policy->MinFresh );
   return policy;
}

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 mit Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Quelle:

HttpRequestCachePolicy.cs

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse unter Verwendung der angegebenen Werte für maximales Alter, Alterssteuerung und Zeit.

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 HttpCacheAgeControl-Wert.

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 nicht gültig.

Beispiele

Im folgenden Codebeispiel wird das Erstellen einer Cacherichtlinie basierend auf minimaler Aktualität und maximalem Alter veranschaulicht.

static HttpRequestCachePolicy^ CreateFreshAndAgePolicy( TimeSpan freshMinimum, TimeSpan ageMaximum )
{
   HttpRequestCachePolicy^ policy = gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MaxAgeAndMinFresh,
       ageMaximum, freshMinimum );
   Console::WriteLine( policy );
   return policy;
}

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 Parameterwerts freshOrStale 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 und die MaxStale -Eigenschaft mithilfe des -Werts des freshOrStale -Parameters festgelegt.

Beachten Sie, dass die MaxAge -Eigenschaft nicht festgelegt ist, es sei denn, Sie geben oder MaxAgeAndMinFreshanMaxAgeAndMaxStale.

Dieser Konstruktor initialisiert die Level-Eigenschaft mit Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Quelle:

HttpRequestCachePolicy.cs

Initialisiert eine neue Instanz der HttpRequestCachePolicy-Klasse unter Verwendung der angegebenen Werte für maximales Alter, Alterssteuerung und Zeit sowie des angegebenen 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 HttpCacheAgeControl-Wert.

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 den Zeitpunkt angibt, zu dem im Cache gespeicherte Ressourcen erneut überprüft werden müssen.

Beispiele

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

static HttpRequestCachePolicy^ CreateFreshAndAgePolicy2( TimeSpan freshMinimum, TimeSpan ageMaximum, DateTime when )
{
   HttpRequestCachePolicy^ policy = 
       gcnew HttpRequestCachePolicy( HttpCacheAgeControl::MaxAgeAndMinFresh, 
       ageMaximum, freshMinimum, when );
   Console::WriteLine( policy );
   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
}

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 Parameterwerts freshOrStale 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 und die MaxStale -Eigenschaft mithilfe des -Werts des freshOrStale -Parameters festgelegt.

Beachten Sie, dass die MaxAge -Eigenschaft nicht festgelegt ist, es sei denn, Sie geben oder MaxAgeAndMinFreshanMaxAgeAndMaxStale.

Dieser Konstruktor initialisiert die CacheSyncDate -Eigenschaft in cacheSyncDateund initialisiert die Level -Eigenschaft in Default.