HttpRequestCachePolicy Konstruktor

Definisi

Ruang nama:

System.Net.Cache

Rakitan:

System.Net.Requests.dll

Menginisialisasi instans baru kelas HttpRequestCachePolicy.

Overload

HttpRequestCachePolicy()	Menginisialisasi instans baru kelas HttpRequestCachePolicy.
HttpRequestCachePolicy(DateTime)	Menginisialisasi instans HttpRequestCachePolicy baru kelas menggunakan tanggal sinkronisasi cache yang ditentukan.
HttpRequestCachePolicy(HttpRequestCacheLevel)	Menginisialisasi instans HttpRequestCachePolicy baru kelas menggunakan kebijakan cache yang ditentukan.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)	Menginisialisasi instans HttpRequestCachePolicy baru kelas menggunakan kontrol usia dan nilai waktu yang ditentukan.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)	Menginisialisasi instans HttpRequestCachePolicy baru kelas menggunakan usia maksimum, nilai kontrol usia, dan nilai waktu yang ditentukan.
HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)	Menginisialisasi instans HttpRequestCachePolicy baru kelas menggunakan usia maksimum, nilai kontrol usia, nilai waktu, dan tanggal sinkronisasi cache yang ditentukan.

HttpRequestCachePolicy()

Sumber:

HttpRequestCachePolicy.cs

Menginisialisasi instans baru kelas HttpRequestCachePolicy.

public:
 HttpRequestCachePolicy();

public HttpRequestCachePolicy ();

Public Sub New ()

Contoh

Contoh kode berikut menunjukkan pengaturan kebijakan cache menggunakan konstruktor ini.

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

Keterangan

Konstruktor ini menginisialisasi Level properti ke Default.

HttpRequestCachePolicy(DateTime)

Sumber:

HttpRequestCachePolicy.cs

Menginisialisasi instans HttpRequestCachePolicy baru kelas menggunakan tanggal sinkronisasi cache yang ditentukan.

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

Objek DateTime yang menentukan waktu ketika sumber daya yang disimpan dalam cache harus divalidasi ulang.

Contoh

Contoh kode berikut menunjukkan pembuatan kebijakan cache berdasarkan tanggal sinkronisasi cache.

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

Keterangan

Tanggal sinkronisasi cache memungkinkan Anda menentukan tanggal absolut saat konten yang dibuat cache harus divalidasi ulang. Jika entri cache terakhir divalidasi ulang sebelum tanggal sinkronisasi cache, validasi ulang dengan server terjadi. Jika entri cache divalidasi ulang setelah tanggal sinkronisasi cache dan tidak ada persyaratan validasi ulang server yang membuat entri cache tidak valid, entri dari cache digunakan. Jika tanggal sinkronisasi cache diatur ke tanggal mendatang, entri akan divalidasi ulang setiap kali diminta, hingga tanggal sinkronisasi cache berlalu.

Konstruktor ini menginisialisasi Level properti ke Default. Properti CacheSyncDate diinisialisasi ke cacheSyncDate.

HttpRequestCachePolicy(HttpRequestCacheLevel)

Sumber:

HttpRequestCachePolicy.cs

Menginisialisasi instans HttpRequestCachePolicy baru kelas menggunakan kebijakan cache yang ditentukan.

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

Sebuah nilai HttpRequestCacheLevel.

Contoh

Contoh kode berikut menunjukkan pembuatan kebijakan cache yang memungkinkan sumber daya yang ditemukan dalam cache digunakan dari cache.

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

Keterangan

Konstruktor ini menginisialisasi Level properti ke level.

Nilai HttpRequestCacheLevel mengontrol apakah penembolokan diaktifkan, dan kapan cache dapat digunakan. Untuk informasi tambahan, lihat HttpRequestCacheLevel dokumentasi.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan)

Sumber:

HttpRequestCachePolicy.cs

Menginisialisasi instans HttpRequestCachePolicy baru kelas menggunakan kontrol usia dan nilai waktu yang ditentukan.

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

Salah satu nilai enumerasi berikut HttpCacheAgeControl : MaxAge, , MaxStaleatau MinFresh.

ageOrFreshOrStale

TimeSpan

Nilai TimeSpan yang menentukan jumlah waktu.

Pengecualian

ArgumentException

Nilai yang ditentukan untuk cacheAgeControl parameter tidak dapat digunakan dengan konstruktor ini.

Contoh

Contoh kode berikut menunjukkan pembuatan kebijakan cache berdasarkan kesegaran minimum.

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

Keterangan

Nilai cacheAgeControl menentukan arti nilai ageOrFreshOrStale parameter dan digunakan untuk mengatur properti terkait. Misalnya, saat Anda menentukan MaxStale, MaxStale properti diatur ke nilai ageOrFreshOrStale parameter .

Konstruktor ini menginisialisasi Level properti ke Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan)

Sumber:

HttpRequestCachePolicy.cs

Menginisialisasi instans HttpRequestCachePolicy baru kelas menggunakan usia maksimum, nilai kontrol usia, dan nilai waktu yang ditentukan.

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

Sebuah nilai HttpCacheAgeControl.

maxAge

TimeSpan

TimeSpan Nilai yang menentukan usia maksimum untuk sumber daya.

freshOrStale

TimeSpan

Nilai TimeSpan yang menentukan jumlah waktu.

Pengecualian

ArgumentException

Nilai yang ditentukan untuk cacheAgeControl parameter tidak valid.

Contoh

Contoh kode berikut menunjukkan pembuatan kebijakan cache berdasarkan kesegaran minimum dan usia maksimum.

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

Keterangan

Nilai cacheAgeControl digunakan untuk menginterpretasikan arti freshOrStale nilai parameter dan mengatur properti terkait. Misalnya, saat Anda menentukan MaxStale, MaxStale properti diatur ke nilai freshOrStale parameter . Saat Anda menentukan MaxAgeAndMaxStale, MaxAge properti diatur menggunakan nilai maxAge parameter dan MaxStale properti diatur menggunakan nilai freshOrStale parameter .

Perhatikan bahwa kecuali Anda menentukan MaxAgeAndMaxStale atau MaxAgeAndMinFresh, MaxAge properti tidak diatur.

Konstruktor ini menginisialisasi Level properti ke Default.

HttpRequestCachePolicy(HttpCacheAgeControl, TimeSpan, TimeSpan, DateTime)

Sumber:

HttpRequestCachePolicy.cs

Menginisialisasi instans HttpRequestCachePolicy baru kelas menggunakan usia maksimum, nilai kontrol usia, nilai waktu, dan tanggal sinkronisasi cache yang ditentukan.

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

Sebuah nilai HttpCacheAgeControl.

maxAge

TimeSpan

TimeSpan Nilai yang menentukan usia maksimum untuk sumber daya.

freshOrStale

TimeSpan

Nilai TimeSpan yang menentukan jumlah waktu.

cacheSyncDate

DateTime

Objek DateTime yang menentukan waktu ketika sumber daya yang disimpan dalam cache harus divalidasi ulang.

Contoh

Contoh kode berikut menunjukkan pembuatan kebijakan cache berdasarkan kesegaran minimum, usia maksimum, dan tanggal sinkronisasi cache.

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
}

Keterangan

Nilai cacheAgeControl digunakan untuk menginterpretasikan arti freshOrStale nilai parameter dan mengatur properti terkait. Misalnya, saat Anda menentukan MaxStale, MaxStale properti diatur ke nilai freshOrStale parameter . Saat Anda menentukan MaxAgeAndMaxStale, MaxAge properti diatur menggunakan nilai maxAge parameter dan MaxStale properti diatur menggunakan nilai freshOrStale parameter .

Perhatikan bahwa kecuali Anda menentukan MaxAgeAndMaxStale atau MaxAgeAndMinFresh, MaxAge properti tidak diatur.

Konstruktor ini menginisialisasi CacheSyncDate properti ke cacheSyncDate, dan menginisialisasi Level properti ke Default.