MemoryCache.AddOrGetExisting Metode

Definisi

Ruang nama:

System.Runtime.Caching

Rakitan:

System.Runtime.Caching.dll

Paket:

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

Sisipkan entri singgahan ke dalam singgahan.

Overload

AddOrGetExisting(CacheItem, CacheItemPolicy)	Menambahkan entri cache ke dalam cache menggunakan instans yang ditentukan CacheItem dan detail tentang cara mengeluarkan entri.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Menambahkan entri cache ke dalam cache menggunakan kunci yang ditentukan dan nilai serta nilai kedaluwarsa absolut.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Menyisipkan entri cache ke dalam cache menggunakan kunci dan nilai yang ditentukan dan detail yang ditentukan tentang bagaimana entri tersebut akan dikeluarkan.

Keterangan

Metode AddOrGetExisting kelebihan beban digunakan untuk menyisipkan entri cache ke dalam cache. Jika entri cache dengan kunci yang cocok tidak ada, metode ini menyisipkan entri baru. Jika entri cache dengan kunci yang cocok sudah ada, mereka mengembalikan entri yang ada.

AddOrGetExisting(CacheItem, CacheItemPolicy)

Sumber:

MemoryCache.cs

Menambahkan entri cache ke dalam cache menggunakan instans yang ditentukan CacheItem dan detail tentang cara mengeluarkan entri.

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

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

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

Public Overrides Function AddOrGetExisting (item As CacheItem, policy As CacheItemPolicy) As CacheItem

Parameter

item

CacheItem

Objek yang akan ditambahkan.

policy

CacheItemPolicy

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

Mengembalikan

CacheItem

Jika ada entri cache dengan kunci yang sama, entri cache yang ada; jika tidak, null.

Pengecualian

ArgumentNullException

Properti Value adalah null.

ArgumentException

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

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

Parameter item memasok kunci dan nilai yang digunakan oleh metode . Jika cache memiliki entri cache dengan kunci yang sama dengan kunci item parameter, metode mengembalikan entri yang ada sebagai CacheItem instans. Jika tidak ada entri cache yang ada, metode membuat yang baru dengan menggunakan kunci dan nilai yang disediakan oleh item parameter, dan dengan detail pengeluaran yang ditentukan oleh policy.

Peringatan

Metode Add dan AddOrGetExisting kelebihan beban tidak mendukung UpdateCallback properti . Oleh karena itu, untuk mengatur UpdateCallback properti untuk entri cache, gunakan Set metode kelebihan beban sebagai gantinya.

AddOrGetExisting(String, Object, DateTimeOffset, String)

Sumber:

MemoryCache.cs

Menambahkan entri cache ke dalam cache menggunakan kunci yang ditentukan dan nilai serta nilai kedaluwarsa absolut.

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

override this.AddOrGetExisting : string * obj * DateTimeOffset * string -> obj

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

Parameter

key

String

Pengidentifikasi unik untuk entri cache yang akan ditambahkan.

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.

Mengembalikan

Object

Jika ada entri cache dengan kunci yang sama, entri cache yang ada; jika tidak, null.

Pengecualian

ArgumentNullException

value bukan null.

NotSupportedException

regionName bukan null.

ArgumentException

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

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

Jika cache tidak memiliki entri cache yang kuncinya cocok dengan key parameter, entri cache baru dibuat, dan MemoryCache.AddOrGetExisting metode kelebihan beban mengembalikan null. Jika ada entri cache yang cocok, entri yang ada akan dikembalikan.

Peringatan

Metode Add dan AddOrGetExisting kelebihan beban tidak mendukung UpdateCallback properti . Oleh karena itu, untuk mengatur UpdateCallback properti untuk entri cache, gunakan Set metode kelebihan beban sebagai gantinya.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Sumber:

MemoryCache.cs

Menyisipkan entri cache ke dalam cache menggunakan kunci dan nilai yang ditentukan dan detail yang ditentukan tentang bagaimana entri tersebut akan dikeluarkan.

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

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

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

Parameter

key

String

Pengidentifikasi unik untuk entri cache untuk ditambahkan atau didapatkan.

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. Secara default, parameter ini adalah null, karena MemoryCache kelas tidak menerapkan wilayah.

Mengembalikan

Object

Jika entri cache yang cocok sudah ada, entri cache; jika tidak, null.

Pengecualian

ArgumentNullException

valueadalah null.

ArgumentException

Nilai kedaluwarsa CacheItemPolicy absolut dan geser InfiniteAbsoluteExpiration objek diatur ke nilai selain default dan NoSlidingExpiration. Kelas MemoryCache tidak dapat menetapkan kebijakan kedaluwarsa berdasarkan kombinasi 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.

-atau-

Panggilan balik penghapusan dan panggilan balik pembaruan telah ditentukan untuk CacheItemPolicy. Satu-satunya MemoryCache dukungan menggunakan satu jenis panggilan balik per entri cache.

ArgumentOutOfRangeException

Properti SlidingExpiration diatur ke nilai yang kurang dari Zero.

-atau-

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

-atau-

Properti Priority bukan nilai CacheItemPriority enumerasi.

Keterangan

Peringatan

Metode Add dan AddOrGetExisting kelebihan beban tidak mendukung UpdateCallback properti . Oleh karena itu, untuk mengatur UpdateCallback properti untuk entri cache, gunakan Set metode kelebihan beban sebagai gantinya.