HttpRequestCachePolicy Konstruktory

Definicja

Przestrzeń nazw:

System.Net.Cache

Zestaw:

System.Net.Requests.dll

Inicjuje nowe wystąpienie klasy HttpRequestCachePolicy.

Przeciążenia

HttpRequestCachePolicy()	Inicjuje nowe wystąpienie klasy HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)	Inicjuje nowe wystąpienie HttpRequestCachePolicy klasy przy użyciu określonej daty synchronizacji pamięci podręcznej.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Inicjuje HttpRequestCachePolicy nowe wystąpienie klasy przy użyciu określonych zasad pamięci podręcznej.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Inicjuje HttpRequestCachePolicy nowe wystąpienie klasy przy użyciu określonej kontrolki wieku i wartości czasu.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Inicjuje HttpRequestCachePolicy nowe wystąpienie klasy przy użyciu określonego maksymalnego wieku, wartości kontroli wieku i wartości czasu.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Inicjuje HttpRequestCachePolicy nowe wystąpienie klasy przy użyciu określonego maksymalnego wieku, wartości kontroli wieku, wartości czasu i daty synchronizacji pamięci podręcznej.

HttpRequestCachePolicy()

Źródło:

HttpRequestCachePolicy.cs

Inicjuje nowe wystąpienie klasy HttpRequestCachePolicy.

public:
 HttpRequestCachePolicy();

public HttpRequestCachePolicy ();

Public Sub New ()

Przykłady

W poniższym przykładzie kodu pokazano ustawienie zasad pamięci podręcznej przy użyciu tego konstruktora.

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

Uwagi

Ten konstruktor inicjuje Level właściwość na .Default

HttpRequestCachePolicy(DateTime)

Źródło:

HttpRequestCachePolicy.cs

Inicjuje nowe wystąpienie HttpRequestCachePolicy klasy przy użyciu określonej daty synchronizacji pamięci podręcznej.

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

DateTime Obiekt, który określa czas, kiedy zasoby przechowywane w pamięci podręcznej muszą zostać ponownie wycofane.

Przykłady

Poniższy przykład kodu przedstawia tworzenie zasad pamięci podręcznej na podstawie daty synchronizacji pamięci podręcznej.

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

Uwagi

Data synchronizacji pamięci podręcznej pozwala określić datę bezwzględną, gdy zawartość w pamięci podręcznej musi zostać ponownie zrewidowana. Jeśli wpis pamięci podręcznej został ostatnio ponownie odnowiony przed datą synchronizacji pamięci podręcznej, nastąpi ponowna aktualizacja z serwerem. Jeśli wpis pamięci podręcznej został ponownie wycofany po dacie synchronizacji pamięci podręcznej i nie ma wymagań dotyczących revalidation serwera, które sprawiają, że wpis buforowany jest nieprawidłowy, używany jest wpis z pamięci podręcznej. Jeśli data synchronizacji pamięci podręcznej jest ustawiona na przyszłą datę, wpis jest ponownie aktualizowany za każdym razem, gdy jest wymagane, do momentu zakończenia daty synchronizacji pamięci podręcznej.

Ten konstruktor inicjuje Level właściwość na .Default Właściwość CacheSyncDate jest inicjowana na wartość cacheSyncDate.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Źródło:

HttpRequestCachePolicy.cs

Inicjuje HttpRequestCachePolicy nowe wystąpienie klasy przy użyciu określonych zasad pamięci podręcznej.

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

Wartość HttpRequestCacheLevel .

Przykłady

W poniższym przykładzie kodu pokazano tworzenie zasad pamięci podręcznej, które umożliwiają korzystanie z pamięci podręcznej zasobów znajdujących się w pamięci podręcznej.

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

Uwagi

Ten konstruktor inicjuje Level właściwość na .level

Wartość HttpRequestCacheLevel określa, czy buforowanie jest włączone, i kiedy można użyć pamięci podręcznej. Aby uzyskać dodatkowe informacje, zobacz dokumentację HttpRequestCacheLevel .

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Źródło:

HttpRequestCachePolicy.cs

Inicjuje HttpRequestCachePolicy nowe wystąpienie klasy przy użyciu określonej kontrolki wieku i wartości czasu.

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 następujących HttpCacheAgeControl wartości wyliczenia: MaxAge, MaxStalelub MinFresh.

ageOrFreshOrStale

TimeSpan

TimeSpan Wartość określająca ilość czasu.

Wyjątki

ArgumentException

Nie można użyć wartości określonej dla parametru cacheAgeControl z tym konstruktorem.

Przykłady

Poniższy przykład kodu przedstawia tworzenie zasad pamięci podręcznej na podstawie minimalnej aktualności.

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

Uwagi

Wartość cacheAgeControl definiuje znaczenie wartości parametru ageOrFreshOrStale i służy do ustawiania skojarzonej właściwości. Na przykład po określeniu MaxStaleMaxStale właściwości jest ustawiona wartość parametru ageOrFreshOrStale .

Ten konstruktor inicjuje Level właściwość na .Default

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Źródło:

HttpRequestCachePolicy.cs

Inicjuje HttpRequestCachePolicy nowe wystąpienie klasy przy użyciu określonego maksymalnego wieku, wartości kontroli wieku i wartości czasu.

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

Wartość HttpCacheAgeControl .

maxAge

TimeSpan

Wartość TimeSpan określająca maksymalny wiek zasobów.

freshOrStale

TimeSpan

TimeSpan Wartość określająca ilość czasu.

Wyjątki

ArgumentException

Wartość określona dla parametru cacheAgeControl jest nieprawidłowa.

Przykłady

Poniższy przykład kodu przedstawia tworzenie zasad pamięci podręcznej na podstawie minimalnej aktualności i maksymalnego wieku.

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

Uwagi

Wartość cacheAgeControl jest używana do interpretowania znaczenia wartości parametru freshOrStale i ustawiania skojarzonej właściwości. Na przykład po określeniu MaxStaleMaxStale właściwości jest ustawiona wartość parametru freshOrStale . Po określeniu MaxAgeAndMaxStaleparametru MaxAge właściwość jest ustawiana przy użyciu wartości parametru maxAge , a MaxStale właściwość jest ustawiana przy użyciu wartości parametru freshOrStale .

Należy pamiętać, że jeśli nie określono MaxAgeAndMaxStale właściwości lub MaxAgeAndMinFresh, właściwość nie jest ustawiona MaxAge .

Ten konstruktor inicjuje Level właściwość na .Default

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Źródło:

HttpRequestCachePolicy.cs

Inicjuje HttpRequestCachePolicy nowe wystąpienie klasy przy użyciu określonego maksymalnego wieku, wartości kontroli wieku, wartości czasu i daty synchronizacji pamięci podręcznej.

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

Wartość HttpCacheAgeControl .

maxAge

TimeSpan

Wartość TimeSpan określająca maksymalny wiek zasobów.

freshOrStale

TimeSpan

TimeSpan Wartość określająca ilość czasu.

cacheSyncDate

DateTime

DateTime Obiekt, który określa czas, kiedy zasoby przechowywane w pamięci podręcznej muszą zostać ponownie wycofane.

Przykłady

Poniższy przykład kodu przedstawia tworzenie zasad pamięci podręcznej na podstawie minimalnej aktualności, maksymalnego wieku i daty synchronizacji pamięci podręcznej.

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
}

Uwagi

Wartość cacheAgeControl jest używana do interpretowania znaczenia wartości parametru freshOrStale i ustawiania skojarzonej właściwości. Na przykład po określeniu MaxStaleMaxStale właściwości jest ustawiona wartość parametru freshOrStale . Po określeniu MaxAgeAndMaxStaleparametru MaxAge właściwość jest ustawiana przy użyciu wartości parametru maxAge , a MaxStale właściwość jest ustawiana przy użyciu wartości parametru freshOrStale .

Należy pamiętać, że jeśli nie określono MaxAgeAndMaxStale właściwości lub MaxAgeAndMinFresh, właściwość nie jest ustawiona MaxAge .

Ten konstruktor inicjuje CacheSyncDate właściwość na cacheSyncDatewartość i inicjuje Level właściwość na wartość Default.