HttpRequestCachePolicy Konstruktory

Definice

Obor názvů:

System.Net.Cache

Sestavení:

netstandard.dll, System.Net.Requests.dll

Inicializuje novou instanci HttpRequestCachePolicy třídy.

Přetížení

Name	Description
HttpRequestCachePolicy()	Inicializuje novou instanci HttpRequestCachePolicy třídy.
HttpRequestCachePolicy(DateTime)	Inicializuje novou instanci HttpRequestCachePolicy třídy pomocí zadaného data synchronizace mezipaměti.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Inicializuje novou instanci HttpRequestCachePolicy třídy pomocí zadané zásady mezipaměti.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Inicializuje novou instanci třídy pomocí zadaného HttpRequestCachePolicy věkového řízení a časových hodnot.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Inicializuje novou instanci HttpRequestCachePolicy třídy pomocí zadaného maximálního věku, hodnoty řízení věku a časové hodnoty.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Inicializuje novou instanci třídy pomocí zadaného maximálního HttpRequestCachePolicy věku, hodnoty řízení věku, hodnoty času a data synchronizace mezipaměti.

HttpRequestCachePolicy()

Zdroj:

HttpRequestCachePolicy.cs

Inicializuje novou instanci HttpRequestCachePolicy třídy.

public:
 HttpRequestCachePolicy();

public HttpRequestCachePolicy();

Public Sub New ()

Příklady

Následující příklad kódu ukazuje nastavení zásady mezipaměti pomocí tohoto konstruktoru.

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

Poznámky

Tento konstruktor inicializuje Level vlastnost na Default.

HttpRequestCachePolicy(DateTime)

Zdroj:

HttpRequestCachePolicy.cs

Inicializuje novou instanci HttpRequestCachePolicy třídy pomocí zadaného data synchronizace mezipaměti.

public:
 HttpRequestCachePolicy(DateTime cacheSyncDate);

public HttpRequestCachePolicy(DateTime cacheSyncDate);

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

Public Sub New (cacheSyncDate As DateTime)

Parametry

cacheSyncDate

DateTime

Objekt DateTime , který určuje čas, kdy musí být prostředky uložené v mezipaměti znovu revalidované.

Příklady

Následující příklad kódu ukazuje vytvoření zásady mezipaměti na základě data synchronizace mezipaměti.

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

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

Poznámky

Datum synchronizace mezipaměti umožňuje zadat absolutní datum, kdy se musí obsah v mezipaměti znovu aktualizovat. Pokud byla položka mezipaměti naposledy znovu aktualizována před datem synchronizace mezipaměti, dojde k opětovnému ověření serveru. Pokud byla položka mezipaměti znovu ověřena po datu synchronizace mezipaměti a neexistují žádné požadavky na obnovení serveru, které zneplatní položku v mezipaměti, použije se položka z mezipaměti. Pokud je datum synchronizace mezipaměti nastaveno na budoucí datum, položka se znovu aktualizuje při každém vyžádání, dokud datum synchronizace mezipaměti nepřejde.

Tento konstruktor inicializuje Level vlastnost na Default. Vlastnost CacheSyncDate je inicializována na cacheSyncDate.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Zdroj:

HttpRequestCachePolicy.cs

Inicializuje novou instanci HttpRequestCachePolicy třídy pomocí zadané zásady mezipaměti.

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)

Parametry

level

HttpRequestCacheLevel

Hodnotu HttpRequestCacheLevel .

Příklady

Následující příklad kódu ukazuje vytvoření zásady mezipaměti, které umožňují prostředky nalezené v mezipaměti použít z mezipaměti.

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

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

Poznámky

Tento konstruktor inicializuje Level vlastnost na level.

Hodnota HttpRequestCacheLevel určuje, jestli je ukládání do mezipaměti povolené a kdy je možné mezipaměť použít. Další informace najdete v HttpRequestCacheLevel dokumentaci.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Zdroj:

HttpRequestCachePolicy.cs

Inicializuje novou instanci třídy pomocí zadaného HttpRequestCachePolicy věkového řízení a časových hodnot.

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)

Parametry

cacheAgeControl

HttpCacheAgeControl

Jedna z následujících HttpCacheAgeControl hodnot výčtu: MaxAge, MaxStalenebo MinFresh.

ageOrFreshOrStale

TimeSpan

Hodnota TimeSpan , která určuje dobu.

Výjimky

ArgumentException

Hodnotu zadanou cacheAgeControl pro parametr nelze použít s tímto konstruktorem.

Příklady

Následující příklad kódu ukazuje vytvoření zásady mezipaměti na základě minimální aktuálnosti.

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

Poznámky

Hodnota cacheAgeControl definuje význam hodnoty parametru ageOrFreshOrStale a slouží k nastavení přidružené vlastnosti. Například při zadání MaxStaleMaxStale je vlastnost nastavena na hodnotu parametruageOrFreshOrStale.

Tento konstruktor inicializuje Level vlastnost na Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Zdroj:

HttpRequestCachePolicy.cs

Inicializuje novou instanci HttpRequestCachePolicy třídy pomocí zadaného maximálního věku, hodnoty řízení věku a časové hodnoty.

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)

Parametry

cacheAgeControl

HttpCacheAgeControl

Hodnotu HttpCacheAgeControl .

maxAge

TimeSpan

Hodnota TimeSpan , která určuje maximální stáří prostředků.

freshOrStale

TimeSpan

Hodnota TimeSpan , která určuje dobu.

Výjimky

ArgumentException

Hodnota zadaná pro parametr cacheAgeControl není platná.

Příklady

Následující příklad kódu ukazuje vytvoření zásady mezipaměti na základě minimální aktuálnosti a maximálního věku.

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

Poznámky

Hodnota cacheAgeControl se používá k interpretaci významu hodnoty parametru freshOrStale a nastavení přidružené vlastnosti. Například při zadání MaxStaleMaxStale je vlastnost nastavena na hodnotu parametrufreshOrStale. Při zadání MaxAgeAndMaxStaleMaxAge je vlastnost nastavena pomocí hodnoty maxAge parametru a MaxStale vlastnost je nastavena pomocí hodnoty parametrufreshOrStale.

Všimněte si, že pokud nezadáte MaxAgeAndMaxStale nebo MaxAgeAndMinFreshMaxAge , vlastnost není nastavena.

Tento konstruktor inicializuje Level vlastnost na Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Zdroj:

HttpRequestCachePolicy.cs

Inicializuje novou instanci třídy pomocí zadaného maximálního HttpRequestCachePolicy věku, hodnoty řízení věku, hodnoty času a data synchronizace mezipaměti.

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)

Parametry

cacheAgeControl

HttpCacheAgeControl

Hodnotu HttpCacheAgeControl .

maxAge

TimeSpan

Hodnota TimeSpan , která určuje maximální stáří prostředků.

freshOrStale

TimeSpan

Hodnota TimeSpan , která určuje dobu.

cacheSyncDate

DateTime

Objekt DateTime , který určuje čas, kdy musí být prostředky uložené v mezipaměti znovu revalidované.

Příklady

Následující příklad kódu ukazuje vytvoření zásady mezipaměti na základě minimální aktuálnosti, maximálního stáří a data synchronizace mezipaměti.

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
}

Poznámky

Hodnota cacheAgeControl se používá k interpretaci významu hodnoty parametru freshOrStale a nastavení přidružené vlastnosti. Například při zadání MaxStaleMaxStale je vlastnost nastavena na hodnotu parametrufreshOrStale. Při zadání MaxAgeAndMaxStaleMaxAge je vlastnost nastavena pomocí hodnoty maxAge parametru a MaxStale vlastnost je nastavena pomocí hodnoty parametrufreshOrStale.

Všimněte si, že pokud nezadáte MaxAgeAndMaxStale nebo MaxAgeAndMinFreshMaxAge , vlastnost není nastavena.

Tento konstruktor inicializuje CacheSyncDate vlastnost na cacheSyncDatea inicializuje Level vlastnost na Default.