Cache.Insert Metode

Definisi

Ruang nama:

System.Web.Caching

Rakitan:

System.Web.dll

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)	Sisipkan objek ke Cache dalam objek dengan dependensi, kebijakan kedaluwarsa dan prioritas, dan delegasi yang dapat Anda gunakan untuk memberi tahu aplikasi Anda saat item yang disisipkan dihapus dari Cache.
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)	Sisipkan 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)

Sisipkan objek ke Cache dalam objek dengan dependensi, kebijakan 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 -> unit

Public 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 setiap dependensi berubah, objek menjadi tidak valid dan dihapus dari cache. Jika tidak ada dependensi, parameter ini berisi null.

absoluteExpiration

DateTime

Waktu kedaluwarsa objek yang disisipkan 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, parameter 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, parameter harus NoAbsoluteExpiration.

priority

CacheItemPriority

Biaya objek relatif terhadap item lain yang disimpan dalam cache, seperti yang CacheItemPriority dinyatakan oleh enumerasi. Nilai ini digunakan oleh cache ketika mengusir 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 saat objek dihapus dari cache. Anda dapat menggunakan ini untuk memberi tahu aplikasi ketika objeknya dihapus dari cache.

Pengecualian

ArgumentNullException

Parameter key atau value adalah null.

ArgumentOutOfRangeException

Anda mengatur slidingExpiration parameter ke kurang dari TimeSpan.Zero atau setara lebih dari satu tahun.

ArgumentException

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

• DateTime
• TimeSpan
• CacheItemPriority
• CacheItemRemovedCallback
• Penembolokan Data Aplikasi

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 -> unit

Public 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 untuk dimasukkan ke dalam cache.

dependencies

CacheDependency

File atau dependensi kunci cache untuk item. Ketika setiap dependensi berubah, objek menjadi tidak valid dan dihapus dari cache. Jika tidak ada dependensi, parameter ini berisi null.

absoluteExpiration

DateTime

Waktu kedaluwarsa objek yang disisipkan 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

ArgumentNullException

Parameter key, value, atau onUpdateCallback adalah null.

ArgumentOutOfRangeException

Anda mengatur slidingExpiration parameter ke kurang dari TimeSpan.Zero atau setara lebih dari satu tahun.

ArgumentException

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

• CacheItemUpdateCallback

Insert(String, Object, CacheDependency)

Sisipkan 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 -> unit

Public 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 setiap dependensi berubah, objek menjadi tidak valid dan dihapus dari cache. Jika tidak ada dependensi, parameter ini berisi null.

Pengecualian

ArgumentNullException

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

• CacheDependency

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 -> unit

Public 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

ArgumentNullException

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

• Penembolokan Data Aplikasi

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 -> unit

Public 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 setiap dependensi berubah, objek menjadi tidak valid dan dihapus dari cache. Jika tidak ada dependensi, parameter ini berisi null.

absoluteExpiration

DateTime

Waktu kedaluwarsa objek yang disisipkan 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, parameter 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

ArgumentNullException

Parameter key atau value adalah null.

ArgumentOutOfRangeException

Anda mengatur slidingExpiration parameter ke kurang dari TimeSpan.Zero atau setara lebih dari satu tahun.

ArgumentException

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

• DateTime
• TimeSpan
• Penembolokan Data Aplikasi