HttpRequestCachePolicy Konstruktory

Definice

Obor názvů:

System.Net.Cache

Sestavení:

System.Net.Requests.dll

Inicializuje novou instanci HttpRequestCachePolicy třídy .

Přetížení

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 HttpRequestCachePolicy třídy pomocí zadané věkové a časové hodnoty.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Inicializuje novou instanci HttpRequestCachePolicy třídy pomocí zadaného maximálního věku, hodnoty kontroly věku a časové hodnoty.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Inicializuje novou instanci HttpRequestCachePolicy třídy pomocí zadaného maximálního stáří, kontrolní hodnoty stáří, časové hodnoty 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ásad mezipaměti pomocí tohoto konstruktoru.

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

Poznámky

Tento konstruktor inicializuje Level vlastnost do 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 ověřované.

Příklady

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

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

Poznámky

Datum synchronizace mezipaměti umožňuje zadat absolutní datum, kdy se obsah v mezipaměti musí znovu aktualizovat. Pokud byla položka mezipaměti naposledy znovu ověřena před datem synchronizace mezipaměti, dojde k opětovnému ověření se serverem. Pokud byla položka mezipaměti po datu synchronizace mezipaměti znovu ověřena a neexistují žádné požadavky na ověření serveru, kvůli kterým by byla položka uložená v mezipaměti neplatná, použije se položka z mezipaměti. Pokud je datum synchronizace mezipaměti nastaveno na budoucí datum, bude položka při každém požadavku znovu ověřena až do uplynutí data synchronizace mezipaměti.

Tento konstruktor inicializuje Level vlastnost do Default. Vlastnost CacheSyncDate se inicializuje do 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

Hodnota HttpRequestCacheLevel .

Příklady

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

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

Poznámky

Tento konstruktor inicializuje Level vlastnost do 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 HttpRequestCachePolicy třídy pomocí zadané věkové a časové hodnoty.

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.

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

Poznámky

Hodnota cacheAgeControl definuje význam hodnoty parametru ageOrFreshOrStale a slouží k nastavení přidružené vlastnosti. Pokud například zadáte MaxStale, MaxStale vlastnost se nastaví na hodnotu parametru ageOrFreshOrStale .

Tento konstruktor inicializuje Level vlastnost do Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Zdroj:

HttpRequestCachePolicy.cs

Inicializuje novou instanci HttpRequestCachePolicy třídy pomocí zadaného maximálního věku, hodnoty kontroly 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

Hodnota 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 cacheAgeControl parametr 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 stáří.

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

Poznámky

Hodnota cacheAgeControl slouží k interpretaci významu hodnoty parametru freshOrStale a nastavení přidružené vlastnosti. Pokud například zadáte MaxStale, MaxStale vlastnost se nastaví na hodnotu parametru freshOrStale . Když zadáte MaxAgeAndMaxStale, MaxAge vlastnost se nastaví pomocí hodnoty parametru maxAgeMaxStale a vlastnost se nastaví pomocí hodnoty parametru freshOrStale .

Mějte na paměti, že pokud nezadáte MaxAgeAndMaxStale nebo MaxAgeAndMinFresh, MaxAge vlastnost není nastavená.

Tento konstruktor inicializuje Level vlastnost do Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Zdroj:

HttpRequestCachePolicy.cs

Inicializuje novou instanci HttpRequestCachePolicy třídy pomocí zadaného maximálního stáří, kontrolní hodnoty stáří, časové hodnoty 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

Hodnota 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 ověřované.

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.

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
}

Poznámky

Hodnota cacheAgeControl slouží k interpretaci významu hodnoty parametru freshOrStale a nastavení přidružené vlastnosti. Pokud například zadáte MaxStale, MaxStale vlastnost se nastaví na hodnotu parametru freshOrStale . Když zadáte MaxAgeAndMaxStale, MaxAge vlastnost se nastaví pomocí hodnoty parametru maxAgeMaxStale a vlastnost se nastaví pomocí hodnoty parametru freshOrStale .

Mějte na paměti, že pokud nezadáte MaxAgeAndMaxStale nebo MaxAgeAndMinFresh, MaxAge vlastnost není nastavená.

Tento konstruktor inicializuje CacheSyncDate vlastnost pro cacheSyncDatea inicializuje Level vlastnost do Default.