HttpRequestCachePolicy Konstruktory

Definicja

Przestrzeń nazw:

System.Net.Cache

Zestawy:

netstandard.dll, System.Net.Requests.dll

Inicjuje nowe wystąpienie klasy HttpRequestCachePolicy.

Przeciążenia

Nazwa	Opis
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 nowe wystąpienie HttpRequestCachePolicy klasy przy użyciu określonych zasad pamięci podręcznej.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Inicjuje nowe wystąpienie HttpRequestCachePolicy klasy przy użyciu określonej kontroli wieku i wartości czasu.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Inicjuje nowe wystąpienie klasy przy użyciu określonego maksymalnego HttpRequestCachePolicy wieku, wartości kontroli wieku i wartości czasu.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Inicjuje nowe wystąpienie klasy przy użyciu określonego maksymalnego HttpRequestCachePolicy wieku, wartości kontroli wieku, wartości godziny 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.

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 określający czas ponownego przechowywania zasobów w pamięci podręcznej.

Przykłady

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

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 umożliwia określenie konkretnej daty, kiedy zawartość w pamięci podręcznej powinna zostać ponownie zweryfikowana. Jeśli wpis pamięci podręcznej został ostatnio wycofany przed datą synchronizacji pamięci podręcznej, nastąpi ponowne odwołanie z serwerem. Jeśli wpis pamięci podręcznej został wycofany po dacie synchronizacji pamięci podręcznej i nie ma żadnych wymagań dotyczących ponownej aktualizacji serwera, które sprawiają, że wpis w pamięci podręcznej jest nieprawidłowy, zostanie użyty wpis z pamięci podręcznej. Jeśli data synchronizacji pamięci podręcznej jest ustawiona na datę przyszłą, wpis jest ponownie weryfikowany za każdym razem, gdy jest żądany, dopóki data synchronizacji pamięci podręcznej nie zostanie przekroczona.

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

HttpRequestCachePolicy(HttpRequestCacheLevel)

Źródło:

HttpRequestCachePolicy.cs

Inicjuje nowe wystąpienie HttpRequestCachePolicy 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ści HttpRequestCacheLevel .

Przykłady

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

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, oraz 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 nowe wystąpienie HttpRequestCachePolicy klasy przy użyciu określonej kontroli 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

W poniższym przykładzie kodu pokazano tworzenie zasad pamięci podręcznej na podstawie minimalnej aktualności.

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 podczas określania MaxStaleMaxStale właściwości właściwość jest ustawiana na wartość parametruageOrFreshOrStale.

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

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Źródło:

HttpRequestCachePolicy.cs

Inicjuje nowe wystąpienie klasy przy użyciu określonego maksymalnego HttpRequestCachePolicy 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ści 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

W poniższym przykładzie kodu pokazano tworzenie zasad pamięci podręcznej na podstawie minimalnej aktualności i maksymalnego wieku.

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 służy do interpretowania znaczenia wartości parametru freshOrStale i ustawiania skojarzonej właściwości. Na przykład podczas określania MaxStaleMaxStale właściwości właściwość jest ustawiana na wartość parametrufreshOrStale. Po określeniu MaxAgeAndMaxStaleparametru MaxAge właściwość jest ustawiana przy użyciu wartości maxAge parametru, 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 nowe wystąpienie klasy przy użyciu określonego maksymalnego HttpRequestCachePolicy wieku, wartości kontroli wieku, wartości godziny 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ści 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 określający czas ponownego przechowywania zasobów w pamięci podręcznej.

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.

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 służy do interpretowania znaczenia wartości parametru freshOrStale i ustawiania skojarzonej właściwości. Na przykład podczas określania MaxStaleMaxStale właściwości właściwość jest ustawiana na wartość parametrufreshOrStale. Po określeniu MaxAgeAndMaxStaleparametru MaxAge właściwość jest ustawiana przy użyciu wartości maxAge parametru, 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 cacheSyncDate, i inicjuje Level właściwość na Default.