MemoryCache.Set Metode

Definisi

Ruang nama:

System.Runtime.Caching

Rakitan:

System.Runtime.Caching.dll

Paket:

System.Runtime.Caching v9.0.0-preview.3.24172.9

Sisipkan entri singgahan ke dalam singgahan.

Overload

Set(CacheItem, CacheItemPolicy)	Menyisipkan entri cache ke dalam cache dengan menggunakan CacheItem instans untuk menyediakan kunci dan nilai untuk entri cache.
Set(String, Object, DateTimeOffset, String)	Menyisipkan entri cache ke dalam cache dengan menggunakan kunci dan nilai dan menentukan detail kedaluwarsa berbasis waktu.
Set(String, Object, CacheItemPolicy, String)	Menyisipkan entri cache ke dalam cache dengan menggunakan kunci dan nilai dan pengeluaran.

Keterangan

Jika entri yang ditentukan tidak ada, entri tersebut dibuat. Jika ada entri yang ditentukan, entri akan diperbarui.

Set(CacheItem, CacheItemPolicy)

Sumber:

MemoryCache.cs

Menyisipkan entri cache ke dalam cache dengan menggunakan CacheItem instans untuk menyediakan kunci dan nilai untuk entri cache.

public:
 override void Set(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public override void Set (System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

override this.Set : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> unit

Public Overrides Sub Set (item As CacheItem, policy As CacheItemPolicy)

Parameter

item

CacheItem

Objek yang mewakili entri cache untuk disisipkan.

policy

CacheItemPolicy

Objek yang berisi detail pengeluaran untuk entri cache. Objek ini menyediakan lebih banyak opsi untuk pengeluaran daripada kedaluwarsa absolut sederhana.

Pengecualian

ArgumentNullException

itemadalah null.

-atau-

Properti Key adalah null.

-atau-

Properti Value adalah null.

ArgumentException

Kombinasi argumen untuk entri cache tidak valid telah diteruskan. Ini terjadi jika detail kedaluwarsa berikut diatur pada objek kebijakan untuk entri cache:

• Jika nilai CacheItemPolicy kedaluwarsa absolut dan geser objek diatur ke nilai selain default InfiniteAbsoluteExpiration bidang dan NoSlidingExpiration . Kelas MemoryCache tidak dapat menetapkan kebijakan kedaluwarsa berdasarkan kedaluwarsa absolut dan kedaluwarsa geser. Hanya satu pengaturan kedaluwarsa MemoryCache yang dapat diatur secara eksplisit saat Anda menggunakan kelas . Pengaturan lainnya harus diatur ke InfiniteAbsoluteExpiration properti atau NoSlidingExpiration .

• Jika panggilan balik penghapusan dan panggilan balik pembaruan ditentukan untuk CacheItemPolicy objek. Kelas MemoryCache hanya mendukung penggunaan satu jenis panggilan balik per entri cache.

ArgumentOutOfRangeException

Properti SlidingExpiration diatur ke nilai yang kurang dari Zero.

-atau-

Properti SlidingExpiration diatur ke nilai yang lebih besar dari satu tahun.

-atau-

Priority bukan nilai enumerasiCacheItemPriority.

Keterangan

Seperti metode lain Set yang kelebihan beban, Set metode ini selalu menempatkan nilai cache di cache, terlepas dari apakah entri sudah ada yang memiliki kunci yang sama. Jika entri yang ditentukan tidak ada di cache, entri cache baru akan disisipkan. Jika entri yang ditentukan sudah ada, nilainya diperbarui.

Set(String, Object, DateTimeOffset, String)

Sumber:

MemoryCache.cs

Menyisipkan entri cache ke dalam cache dengan menggunakan kunci dan nilai dan menentukan detail kedaluwarsa berbasis waktu.

public override void Set (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

override this.Set : string * obj * DateTimeOffset * string -> unit

Public Overrides Sub Set (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing)

Parameter

key

String

Pengidentifikasi unik untuk entri cache untuk disisipkan.

value

Object

Data untuk entri cache.

absoluteExpiration

DateTimeOffset

Tanggal dan waktu tetap di mana entri cache akan kedaluwarsa.

regionName

String

Wilayah bernama dalam cache tempat entri cache dapat ditambahkan. Jangan berikan nilai untuk parameter ini. Parameter ini null secara default, karena MemoryCache kelas tidak menerapkan wilayah.

Pengecualian

NotSupportedException

regionName bukan null.

ArgumentNullException

keyadalah null.

-atau-

Valueadalah null.

ArgumentException

• Kombinasi argumen untuk entri cache tidak valid telah diteruskan. Ini terjadi jika detail kedaluwarsa berikut diatur pada objek kebijakan untuk entri cache:

• Jika nilai kedaluwarsa absolut dan geser InfiniteAbsoluteExpiration pada CacheItemPolicy objek diatur ke nilai selain default dan NoSlidingExpiration. Ini terjadi karena kelas tidak mendukung entri yang kedaluwarsa MemoryCache berdasarkan absolut dan kedaluwarsa geser. Hanya satu pengaturan kedaluwarsa MemoryCache yang dapat diatur secara eksplisit saat Anda menggunakan kelas . Pengaturan lainnya harus diatur ke InfiniteAbsoluteExpiration atau NoSlidingExpiration.

• Jika panggilan balik penghapusan dan panggilan balik pembaruan ditentukan pada CacheItemPolicy objek. Kelas MemoryCache hanya mendukung penggunaan satu jenis panggilan balik per entri cache.

ArgumentOutOfRangeException

Properti SlidingExpiration diatur ke nilai yang kurang dari Zero.

-atau-

Properti SlidingExpiration diatur ke nilai yang lebih besar dari satu tahun.

-atau-

• Properti Priority bukan nilai CacheItemPriority enumerasi.

Keterangan

Seperti metode lain Set yang kelebihan beban, Set metode ini selalu menempatkan nilai cache di cache, terlepas dari apakah entri sudah ada dengan kunci yang sama. Jika entri yang ditentukan tidak ada, entri cache baru akan disisipkan. Jika ada entri yang ditentukan, entri akan diperbarui.

Parameter absoluteExpiration menunjukkan kapan entri harus dihapus dari cache.

Menghapus entri memicu monitor perubahan terkait. Jika item yang dihapus dikaitkan dengan CacheItemUpdateCallback objek atau CacheItemRemovedCallback objek, alasan penghapusan yang diteruskan ke panggilan balik terkandung dalam Removed properti .

Set(String, Object, CacheItemPolicy, String)

Sumber:

MemoryCache.cs

Menyisipkan entri cache ke dalam cache dengan menggunakan kunci dan nilai dan pengeluaran.

public override void Set (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

override this.Set : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> unit

Public Overrides Sub Set (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing)

Parameter

key

String

Pengidentifikasi unik untuk entri cache untuk disisipkan.

value

Object

Data untuk entri cache.

policy

CacheItemPolicy

Objek yang berisi detail pengeluaran untuk entri cache. Objek ini menyediakan lebih banyak opsi untuk pengeluaran daripada kedaluwarsa absolut sederhana.

regionName

String

Wilayah bernama dalam cache tempat entri cache dapat ditambahkan. Jangan berikan nilai untuk parameter ini. Parameter ini null secara default, karena MemoryCache kelas tidak menerapkan wilayah.

Pengecualian

ArgumentNullException

keyadalah null.

-atau-

value is null

-atau-

Referensi panggilan balik yang diteruskan ke metode pembantu UpdateCallback di properti adalah null.

ArgumentException

• Ada kombinasi argumen yang tidak valid untuk entri cache. Ini terjadi jika detail kedaluwarsa berikut diatur pada objek kebijakan untuk entri cache:

• Jika nilai kedaluwarsa absolut dan geser InfiniteAbsoluteExpiration pada CacheItemPolicy objek diatur ke nilai selain default dan NoSlidingExpiration. Ini karena kelas tidak mendukung entri yang kedaluwarsa MemoryCache berdasarkan kedaluwarsa absolut dan geser. Hanya satu pengaturan kedaluwarsa MemoryCache yang dapat diatur secara eksplisit saat Anda menggunakan kelas . Pengaturan lainnya harus diatur ke InfiniteAbsoluteExpiration atau NoSlidingExpiration.

• Jika panggilan balik penghapusan dan panggilan balik pembaruan ditentukan pada CacheItemPolicy kelas . Kelas MemoryCache hanya mendukung penggunaan satu jenis panggilan balik per entri cache.

ArgumentOutOfRangeException

Properti SlidingExpiration diatur ke nilai yang kurang dari Zero.

-atau-

Properti SlidingExpiration diatur ke nilai yang lebih besar dari satu tahun.

-atau-

Properti Priority bukan nilai CacheItemPriority enumerasi.

NotSupportedException

regionName bukan null.

Keterangan

Seperti metode lain Set yang kelebihan beban, Set metode ini selalu menempatkan nilai cache di cache, terlepas dari apakah entri yang cocok sudah ada. Jika entri yang ditentukan tidak ada di cache, entri cache baru akan disisipkan. Jika ada entri yang ditentukan, entri akan diperbarui.

Menghapus entri memicu monitor perubahan terkait. Jika item yang dihapus dikaitkan dengan CacheItemUpdateCallback objek atau CacheItemRemovedCallback objek, alasan penghapusan yang diteruskan ke panggilan balik terkandung dalam Removed properti .