ObjectCache.Add Metode

Definisi

Ruang nama:

System.Runtime.Caching

Rakitan:

System.Runtime.Caching.dll

Paket:

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

Saat ditimpa di kelas turunan, sisipkan entri cache ke dalam cache, tanpa mengharuskan entri cache yang ada dengan kunci yang cocok dikembalikan.

Overload

Add(CacheItem, CacheItemPolicy)	Saat ditimpa di kelas turunan, mencoba menyisipkan entri cache ke dalam cache sebagai CacheItem instans, dan menambahkan detail tentang bagaimana entri harus dikeluarkan.
Add(String, Object, DateTimeOffset, String)	Saat ditimpa di kelas turunan, sisipkan entri cache ke dalam cache tanpa menimpa entri cache yang ada.
Add(String, Object, CacheItemPolicy, String)	Ketika ditimpa di kelas turunan, menyisipkan entri cache ke dalam cache, menentukan informasi tentang bagaimana entri akan dikeluarkan.

Keterangan

Metode Add kelebihan beban mencoba memasukkan entri cache ke dalam cache, tanpa menimpa atau menghapus entri cache yang ada yang memiliki kunci yang sama. Entri cache dapat berupa objek yang diketik CacheItem atau objek generik.

Metode AddOrGetExisting kelebihan beban dan Add metode kelebihan beban memiliki satu perbedaan yang signifikan. Ketika metode ini menyisipkan entri cache, jika entri yang cocok ditemukan di cache, AddOrGetExisting metode kelebihan beban mengembalikan entri cache yang ada, tetapi Add metode kelebihan beban tidak. Memiliki kelebihan beban metode yang berbeda ini memungkinkan penelepon untuk mengoptimalkan kode mereka berdasarkan apakah mereka memerlukan entri cache yang ada. Dalam cache terdistribusi, mengembalikan nilai yang ada dengan menggunakan AddOrGetExisting metode mungkin lebih mahal daripada mengembalikan nilai Boolean dengan menggunakan Add metode .

Add(CacheItem, CacheItemPolicy)

Sumber:

ObjectCache.cs

Saat ditimpa di kelas turunan, mencoba menyisipkan entri cache ke dalam cache sebagai CacheItem instans, dan menambahkan detail tentang bagaimana entri harus dikeluarkan.

public:
 virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public virtual bool Add (System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool

Public Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean

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

Boolean

true jika penyisipan berhasil, atau false jika sudah ada entri dalam cache yang memiliki kunci yang sama dengan item.

Keterangan

Metode Add kelebihan beban adalah virtual (tidak abstrak) pada ObjectCache kelas , karena Add metode secara internal memanggil AddOrGetExisting. Ini mengurangi jumlah kelebihan metode yang harus disediakan oleh pelaksana cache. Jika implementasi cache tidak memerlukan perilaku khusus untuk metode ini Add , itu hanya dapat mengimplementasikan AddOrGetExisting metode kelebihan beban.

Add(String, Object, DateTimeOffset, String)

Sumber:

ObjectCache.cs

Saat ditimpa di kelas turunan, sisipkan entri cache ke dalam cache tanpa menimpa entri cache yang ada.

public virtual bool Add (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> bool

Public Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Boolean

Parameter

key

String

Pengidentifikasi unik untuk entri cache.

value

Object

Objek yang akan disisipkan.

absoluteExpiration

DateTimeOffset

Tanggal dan waktu tetap di mana entri cache akan kedaluwarsa. Parameter ini diperlukan ketika Add metode dipanggil.

regionName

String

Pilihan. Wilayah bernama dalam cache tempat entri cache dapat ditambahkan, jika wilayah diterapkan. Karena wilayah tidak diimplementasikan dalam .NET Framework 4, nilai defaultnya adalah null.

Mengembalikan

Boolean

true jika penyisipan berhasil, atau false jika sudah ada entri dalam cache yang memiliki kunci yang sama dengan key.

Keterangan

Metode Add kelebihan beban adalah virtual (tidak abstrak) pada ObjectCache kelas , karena Add metode secara internal memanggil AddOrGetExisting. Ini mengurangi jumlah kelebihan metode yang harus disediakan oleh pelaksana cache. Jika implementasi cache tidak memerlukan perilaku khusus untuk metode ini Add , itu hanya dapat mengimplementasikan AddOrGetExisting metode kelebihan beban.

Add(String, Object, CacheItemPolicy, String)

Sumber:

ObjectCache.cs

Ketika ditimpa di kelas turunan, menyisipkan entri cache ke dalam cache, menentukan informasi tentang bagaimana entri akan dikeluarkan.

public virtual bool Add (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool

Public Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Boolean

Parameter

key

String

Pengidentifikasi unik untuk entri cache.

value

Object

Objek yang akan disisipkan.

policy

CacheItemPolicy

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

regionName

String

Pilihan. Wilayah bernama dalam cache tempat entri cache dapat ditambahkan, jika wilayah diterapkan. Nilai default untuk parameter opsional adalah null.

Mengembalikan

Boolean

true jika percobaan penyisipan berhasil, atau false jika sudah ada entri dalam cache dengan kunci yang sama dengan key.

Keterangan

Metode Add kelebihan beban adalah virtual (tidak abstrak) pada ObjectCache kelas , karena Add metode secara internal memanggil AddOrGetExisting. Ini mengurangi jumlah kelebihan metode yang harus disediakan oleh pelaksana cache. Jika implementasi cache tidak memerlukan perilaku khusus untuk metode ini Add , itu hanya dapat mengimplementasikan AddOrGetExisting metode kelebihan beban.