Cache.Insert Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyisipkan item ke Cache dalam objek. Gunakan salah satu versi metode ini untuk menimpa item yang ada Cache dengan parameter yang sama key .
Overload
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) |
Menyisipkan objek ke Cache dalam objek dengan kebijakan dependensi, kedaluwarsa dan prioritas, dan delegasi yang dapat Anda gunakan untuk memberi tahu aplikasi Anda saat item yang disisipkan dihapus dari |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback) |
Menyisipkan objek ke Cache dalam objek bersama dengan dependensi, kebijakan kedaluwarsa, dan delegasi yang dapat Anda gunakan untuk memberi tahu aplikasi sebelum item dihapus dari cache. |
| Insert(String, Object, CacheDependency) |
Menyisipkan objek ke Cache dalam yang memiliki dependensi file atau kunci. |
| Insert(String, Object) |
Menyisipkan item ke Cache dalam objek dengan kunci cache untuk mereferensikan lokasinya, menggunakan nilai default yang disediakan oleh CacheItemPriority enumerasi. |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan) |
Menyisipkan objek ke dalam dengan dependensi dan kebijakan kedaluwarsa Cache . |
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)
Menyisipkan objek ke Cache dalam objek dengan kebijakan dependensi, kedaluwarsa dan prioritas, dan delegasi yang dapat Anda gunakan untuk memberi tahu aplikasi Anda saat item yang disisipkan dihapus dari Cache.
public:
void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemPriority priority, System::Web::Caching::CacheItemRemovedCallback ^ onRemoveCallback);public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemPriority priority, System.Web.Caching.CacheItemRemovedCallback onRemoveCallback);member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback)Parameter
- key
- String
Kunci cache yang digunakan untuk mereferensikan objek.
- value
- Object
Objek yang akan disisipkan dalam cache.
- dependencies
- CacheDependency
File atau dependensi kunci cache untuk item. Ketika ada dependensi yang berubah, objek menjadi tidak valid dan dihapus dari cache. Jika tidak ada dependensi, parameter ini berisi null.
- absoluteExpiration
- DateTime
Waktu saat objek yang disisipkan kedaluwarsa dan dihapus dari cache. Untuk menghindari kemungkinan masalah dengan waktu lokal seperti perubahan dari waktu standar ke waktu musim panas, gunakan UtcNow daripada Now untuk nilai parameter ini. Jika Anda menggunakan kedaluwarsa slidingExpiration absolut, parameternya harus NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Interval antara waktu objek yang disisipkan terakhir diakses dan waktu kedaluwarsa objek tersebut. Jika nilai ini setara dengan 20 menit, objek akan kedaluwarsa dan dihapus dari cache 20 menit setelah terakhir diakses. Jika Anda menggunakan kedaluwarsa absoluteExpiration geser, parameternya harus NoAbsoluteExpiration.
- priority
- CacheItemPriority
Biaya objek relatif terhadap item lain yang disimpan dalam cache, seperti yang dinyatakan oleh CacheItemPriority enumerasi. Nilai ini digunakan oleh cache saat mengeluarkan objek; objek dengan biaya yang lebih rendah dihapus dari cache sebelum objek dengan biaya yang lebih tinggi.
- onRemoveCallback
- CacheItemRemovedCallback
Delegasi yang, jika disediakan, akan dipanggil ketika objek dihapus dari cache. Anda dapat menggunakan ini untuk memberi tahu aplikasi ketika objeknya dihapus dari cache.
Pengecualian
Parameter key atau value adalah null.
Anda mengatur slidingExpiration parameter menjadi kurang dari TimeSpan.Zero atau setara lebih dari satu tahun.
Parameter absoluteExpiration dan slidingExpiration keduanya diatur untuk item yang anda coba tambahkan ke Cache.
Contoh
Contoh berikut menunjukkan cara menetapkan prioritas tinggi item saat Anda menyisipkannya ke dalam objek aplikasi Cache Anda.
Catatan
Untuk informasi selengkapnya tentang cara menggunakan metode ini dengan CacheItemRemovedCallback delegasi, lihat Cara: Memberi tahu Aplikasi Saat Item Dihapus dari Cache.
Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove);
Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove)
Keterangan
Metode ini akan menimpa item yang ada Cache dengan parameter yang sama key .
Anda tidak dapat mengatur absoluteExpiration parameter dan slidingExpiration . Jika Anda ingin item cache kedaluwarsa pada waktu tertentu, Anda mengatur absoluteExpiration parameter ke waktu tertentu, dan slidingExpiration parameter ke NoSlidingExpiration.
Jika Anda ingin item cache kedaluwarsa setelah jumlah waktu tertentu berlalu sejak akses terakhir ke item, Anda mengatur slidingExpiration parameter ke interval kedaluwarsa, dan absoluteExpiration parameter ke NoAbsoluteExpiration.
Lihat juga
Berlaku untuk
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)
Menyisipkan objek ke Cache dalam objek bersama dengan dependensi, kebijakan kedaluwarsa, dan delegasi yang dapat Anda gunakan untuk memberi tahu aplikasi sebelum item dihapus dari cache.
public:
void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemUpdateCallback ^ onUpdateCallback);public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemUpdateCallback onUpdateCallback);member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemUpdateCallback -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, onUpdateCallback As CacheItemUpdateCallback)Parameter
- key
- String
Kunci cache yang digunakan untuk mereferensikan objek.
- value
- Object
Objek yang akan dimasukkan ke dalam cache.
- dependencies
- CacheDependency
File atau dependensi kunci cache untuk item. Ketika ada dependensi yang berubah, objek menjadi tidak valid dan dihapus dari cache. Jika tidak ada dependensi, parameter ini berisi null.
- absoluteExpiration
- DateTime
Waktu saat objek yang disisipkan kedaluwarsa dan dihapus dari cache. Untuk menghindari kemungkinan masalah dengan waktu lokal seperti perubahan dari waktu standar ke waktu musim panas, gunakan UtcNow alih-alih Now untuk nilai parameter ini. Jika Anda menggunakan kedaluwarsa slidingExpiration absolut, parameter harus diatur ke NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Interval antara waktu objek yang di-cache terakhir diakses dan waktu kedaluwarsa objek tersebut. Jika nilai ini setara dengan 20 menit, objek akan kedaluwarsa dan dihapus dari cache 20 menit setelah terakhir diakses. Jika Anda menggunakan kedaluwarsa absoluteExpiration geser, parameter harus diatur ke NoAbsoluteExpiration.
- onUpdateCallback
- CacheItemUpdateCallback
Delegasi yang akan dipanggil sebelum objek dihapus dari cache. Anda dapat menggunakan ini untuk memperbarui item yang di-cache dan memastikan bahwa item tersebut tidak dihapus dari cache.
Pengecualian
Parameter key, value, atau onUpdateCallback adalah null.
Anda mengatur slidingExpiration parameter menjadi kurang dari TimeSpan.Zero atau setara lebih dari satu tahun.
Parameter absoluteExpiration dan slidingExpiration keduanya diatur untuk item yang anda coba tambahkan ke Cache.
-atau-
Parameternya dependencies adalah null, dan absoluteExpiration parameter diatur ke NoAbsoluteExpiration, dan slidingExpiration parameter diatur ke NoSlidingExpiration.
Keterangan
Metode ini Insert memungkinkan Anda menyisipkan item baru dalam cache dan menyediakan delegasi yang dipanggil sebelum item dihapus dari cache. Di delegasi, Anda dapat memperbarui item yang di-cache dan dengan demikian mencegahnya dihapus dari cache.
Metode ini akan menimpa item yang ada Cache dengan parameter yang sama key .
Anda tidak dapat mengatur absoluteExpiration parameter dan slidingExpiration . Jika Anda ingin item cache kedaluwarsa pada waktu tertentu, Anda mengatur absoluteExpiration parameter ke waktu tertentu, dan slidingExpiration parameter ke NoSlidingExpiration.
Jika Anda ingin item cache kedaluwarsa setelah periode waktu yang ditetapkan sejak item terakhir diakses, Anda mengatur slidingExpiration parameter ke interval kedaluwarsa, dan Anda mengatur absoluteExpiration parameter ke NoAbsoluteExpiration.
Lihat juga
Berlaku untuk
Insert(String, Object, CacheDependency)
Menyisipkan objek ke Cache dalam yang memiliki dependensi file atau kunci.
public:
void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies);public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies);member this.Insert : string * obj * System.Web.Caching.CacheDependency -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency)Parameter
- key
- String
Kunci cache yang digunakan untuk mengidentifikasi item.
- value
- Object
Objek yang akan disisipkan dalam cache.
- dependencies
- CacheDependency
File atau dependensi kunci cache untuk objek yang disisipkan. Ketika ada dependensi yang berubah, objek menjadi tidak valid dan dihapus dari cache. Jika tidak ada dependensi, parameter ini berisi null.
Pengecualian
Parameter key atau value adalah null.
Contoh
Contoh berikut menunjukkan cara menyisipkan item ke dalam cache aplikasi dengan dependensi cache pada file konfigurasi XML.
Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));
Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))
Keterangan
Metode ini akan menimpa item cache yang ada yang kuncinya cocok dengan key parameter . Objek yang ditambahkan ke cache menggunakan kelebihan beban Insert metode ini dimasukkan dengan prioritas Default, nilai NoSlidingExpirationkedaluwarsa geser , dan nilai kedaluwarsa absolut .NoAbsoluteExpiration
Lihat juga
Berlaku untuk
Insert(String, Object)
Menyisipkan item ke Cache dalam objek dengan kunci cache untuk mereferensikan lokasinya, menggunakan nilai default yang disediakan oleh CacheItemPriority enumerasi.
public:
void Insert(System::String ^ key, System::Object ^ value);public void Insert (string key, object value);member this.Insert : string * obj -> unitPublic Sub Insert (key As String, value As Object)Parameter
- key
- String
Kunci cache yang digunakan untuk mereferensikan item.
- value
- Object
Objek yang akan dimasukkan ke dalam cache.
Pengecualian
Parameter key atau value adalah null.
Contoh
Contoh berikut menunjukkan cara menyisipkan item ke dalam cache aplikasi.
Cache.Insert("DSN", connectionString);
Cache.Insert("DSN", connectionString)
Keterangan
Metode ini akan menimpa item cache yang ada yang kuncinya cocok dengan key parameter . Objek yang ditambahkan ke cache menggunakan kelebihan beban Insert metode ini dimasukkan tanpa dependensi file atau cache, prioritas Default, nilai NoSlidingExpirationkedaluwarsa geser , dan nilai kedaluwarsa absolut .NoAbsoluteExpiration
Lihat juga
Berlaku untuk
Insert(String, Object, CacheDependency, DateTime, TimeSpan)
Menyisipkan objek ke dalam dengan dependensi dan kebijakan kedaluwarsa Cache .
public:
void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan -> unitPublic Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan)Parameter
- key
- String
Kunci cache yang digunakan untuk mereferensikan objek.
- value
- Object
Objek yang akan disisipkan dalam cache.
- dependencies
- CacheDependency
File atau dependensi kunci cache untuk objek yang disisipkan. Ketika ada dependensi yang berubah, objek menjadi tidak valid dan dihapus dari cache. Jika tidak ada dependensi, parameter ini berisi null.
- absoluteExpiration
- DateTime
Waktu saat objek yang disisipkan kedaluwarsa dan dihapus dari cache. Untuk menghindari kemungkinan masalah dengan waktu lokal seperti perubahan dari waktu standar ke waktu musim panas, gunakan UtcNow daripada Now untuk nilai parameter ini. Jika Anda menggunakan kedaluwarsa slidingExpiration absolut, parameternya harus NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Interval antara waktu objek yang disisipkan terakhir diakses dan waktu kedaluwarsa objek tersebut. Jika nilai ini setara dengan 20 menit, objek akan kedaluwarsa dan dihapus dari cache 20 menit setelah terakhir diakses. Jika Anda menggunakan kedaluwarsa absoluteExpiration geser, parameternya harus NoAbsoluteExpiration.
Pengecualian
Parameter key atau value adalah null.
Anda mengatur slidingExpiration parameter menjadi kurang dari TimeSpan.Zero atau setara lebih dari satu tahun.
Parameter absoluteExpiration dan slidingExpiration keduanya diatur untuk item yang anda coba tambahkan ke Cache.
Contoh
Contoh berikut menunjukkan cara menyisipkan item ke dalam cache aplikasi dengan kedaluwarsa absolut.
Catatan
Karena bentuk Insert metode ini mendukung dependensi cache, jika item tidak memiliki dependensi, Anda harus mendeklarasikan dependency parameter sebagai null (Nothing dalam Visual Basic) dalam daftar parameter yang dibatasi koma.
Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);
Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)
Contoh berikut menunjukkan cara menyisipkan item ke dalam cache dengan kedaluwarsa geser.
Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));
Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))
Keterangan
Metode ini akan menimpa item yang ada Cache dengan parameter yang sama key .
Jika parameter diatur ke , kedaluwarsa slidingExpirationNoSlidingExpirationgeser dinonaktifkan. Jika Anda mengatur slidingExpiration parameter ke lebih besar dari Zero, absoluteExpiration parameter diatur ke Now ditambah nilai yang terkandung dalam slidingExpiration parameter . Jika item diminta dari cache sebelum jumlah waktu yang ditentukan oleh absoluteExpiration parameter, item akan ditempatkan di cache lagi, dan absoluteExpiration akan kembali diatur ke DateTime.Now ditambah nilai yang terkandung dalam slidingExpiration parameter . Jika item tidak diminta dari cache sebelum tanggal dalam absoluteExpiration parameter, item akan dihapus dari cache. Item yang ditambahkan ke cache menggunakan kelebihan beban metode sisipkan ini disisipkan dengan prioritas Default.
Lihat juga
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk