Cache.Insert Yöntem

Tanım

Ad Alanı:: System.Web.Caching

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Nesneye Cache bir öğe ekler. Aynı Cache parametreye sahip mevcut key bir öğenin üzerine yazmak için bu yöntemin sürümlerinden birini kullanın.

Aşırı Yüklemeler

Name	Description
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)	Nesnesine Cache bağımlılıkları, süre sonu ve öncelik ilkeleriyle bir nesne ekler ve eklenen öğe öğesi öğesinden `Cache`kaldırıldığında uygulamanızı bilgilendirmek için kullanabileceğiniz bir temsilci ekler.
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)	Nesneye Cache bağımlılıklar, süre sonu ilkeleri ve öğe önbellekten kaldırılmadan önce uygulamayı bilgilendirmek için kullanabileceğiniz bir temsilciyle birlikte bir nesne ekler.
Insert(String, Object, CacheDependency)	dosyasına dosya veya anahtar bağımlılıkları olan bir nesne Cache ekler.
Insert(String, Object)	Sabit listesi tarafından sağlanan varsayılan değerleri kullanarak konumuna başvurmak için nesneye Cache önbellek anahtarıyla bir öğe CacheItemPriority ekler.
Insert(String, Object, CacheDependency, DateTime, TimeSpan)	bağımlılıkları ve süre sonu ilkeleriyle içine Cache bir nesne ekler.

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

Nesnesine Cache bağımlılıkları, süre sonu ve öncelik ilkeleriyle bir nesne ekler ve eklenen öğe öğesi öğesinden Cachekaldırıldığında uygulamanızı bilgilendirmek için kullanabileceğiniz bir temsilci ekler.

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)

Parametreler

key: String

Nesneye başvurmak için kullanılan önbellek anahtarı.

value: Object

Önbelleğe eklenecek nesne.

dependencies: CacheDependency

Öğenin dosya veya önbellek anahtarı bağımlılıkları. Herhangi bir bağımlılık değiştiğinde, nesne geçersiz hale gelir ve önbellekten kaldırılır. Bağımlılık yoksa, bu parametre içerir null.

absoluteExpiration: DateTime

Eklenen nesnenin süresinin dolduğu ve önbellekten kaldırıldığı saat. Standart saat ile yaz saati arasında değişiklik gibi yerel saatle ilgili olası sorunları önlemek için bu parametre değeri yerine UtcNow kullanınNow. Mutlak süre sonu kullanıyorsanız parametresi slidingExpiration olmalıdır NoSlidingExpiration.

slidingExpiration: TimeSpan

Eklenen nesnenin son erişildiği zaman ile bu nesnenin süresinin dolma zamanı arasındaki aralık. Bu değer 20 dakikanın eşdeğeriyse, nesnenin süresi dolar ve son erişildikten 20 dakika sonra önbellekten kaldırılır. Kayan süre sonu kullanıyorsanız parametresi absoluteExpiration olmalıdır NoAbsoluteExpiration.

priority: CacheItemPriority

Sabit listesi tarafından ifade edildiği gibi, önbellekte depolanan diğer öğelere göre nesnenin CacheItemPriority maliyeti. Bu değer, nesneleri çıkardığında önbellek tarafından kullanılır; daha düşük maliyetli nesneler, daha yüksek maliyetli nesnelerden önce önbellekten kaldırılır.

onRemoveCallback: CacheItemRemovedCallback

Bir nesne önbellekten kaldırıldığında, sağlanırsa çağrılacak bir temsilci. Nesneleri önbellekten silindiğinde uygulamaları bilgilendirmek için bunu kullanabilirsiniz.

Özel durumlar

ArgumentNullException

key veya value parametresidirnull.

ArgumentOutOfRangeException

parametresini slidingExpiration bir yıldan küçük TimeSpan.Zero veya eşdeğeri olarak ayarlarsınız.

ArgumentException

ve parametrelerinin absoluteExpiration her ikisi de öğesine eklemeye çalıştığınız öğe için ayarlanmıştırslidingExpiration.Cache

Örnekler

Aşağıdaki örnekte, bir öğeyi uygulamanızın nesnesine eklediğinizde yüksek öncelikli atama işlemi gösterilmektedir Cache .

Note

Temsilciyle CacheItemRemovedCallback bu yöntemi kullanma hakkında daha fazla bilgi için bkz . Nasıl yapılır: Önbellekten Bir Öğe Kaldırıldığında Uygulamaya Bildirme.

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)

Açıklamalar

Bu yöntem, aynı Cache parametreye sahip mevcut key bir öğenin üzerine yazar.

ve absoluteExpiration parametrelerinin slidingExpiration ikisini de ayarlayamazsınız. Önbellek öğesinin süresinin belirli bir zamanda dolmasına niyetliyseniz, parametresini absoluteExpiration belirli bir zamana ve parametresini slidingExpiration olarak NoSlidingExpirationayarlarsınız.

Öğeye son erişimden bu yana belirli bir süre geçtikten sonra önbellek öğesinin süresinin dolmasına karar verirseniz, parametresini süre sonu aralığına ve parametresini slidingExpiration olarak absoluteExpirationayarlarsınızNoAbsoluteExpiration.

Ayrıca bkz.

Şunlara uygulanır

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)

Nesneye Cache bağımlılıklar, süre sonu ilkeleri ve öğe önbellekten kaldırılmadan önce uygulamayı bilgilendirmek için kullanabileceğiniz bir temsilciyle birlikte bir nesne ekler.

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)

Parametreler

key: String

Nesneye başvurmak için kullanılan önbellek anahtarı.

value: Object

Önbelleğe eklenecek nesne.

dependencies: CacheDependency

absoluteExpiration: DateTime

Eklenen nesnenin süresinin dolduğu ve önbellekten kaldırıldığı saat. Standart saat ile yaz saati arasında değişiklik gibi yerel saatle ilgili olası sorunları önlemek için bu parametre değeri yerine UtcNow kullanınNow. Mutlak süre sonu kullanıyorsanız parametresi olarak slidingExpirationNoSlidingExpirationayarlanmalıdır.

slidingExpiration: TimeSpan

Önbelleğe alınan nesneye en son erişilen zaman ile bu nesnenin süresinin dolma zamanı arasındaki zaman aralığı. Bu değer 20 dakikanın eşdeğeriyse, nesnenin süresi dolar ve son erişildikten 20 dakika sonra önbellekten kaldırılır. Kayan süre sonu kullanıyorsanız parametresi absoluteExpiration olarak NoAbsoluteExpirationayarlanmalıdır.

onUpdateCallback: CacheItemUpdateCallback

Nesne önbellekten kaldırılmadan önce çağrılacak bir temsilci. Önbelleğe alınan öğeyi güncelleştirmek ve önbellekten kaldırılmadığından emin olmak için bunu kullanabilirsiniz.

Özel durumlar

ArgumentNullException

key, valueveya onUpdateCallback parametresidirnull.

ArgumentOutOfRangeException

parametresini slidingExpiration bir yıldan küçük TimeSpan.Zero veya eşdeğeri olarak ayarlarsınız.

ArgumentException

ve parametrelerinin absoluteExpiration her ikisi de öğesine eklemeye çalıştığınız öğe için ayarlanmıştırslidingExpiration.Cache

-veya-

dependencies parametresi , nullabsoluteExpiration parametresi ise olarak, NoAbsoluteExpirationslidingExpiration parametresi ise olarak NoSlidingExpirationayarlanır.

Açıklamalar

Insert yöntemi, önbelleğe yeni bir öğe eklemenize ve öğe önbellekten kaldırılmadan önce çağrılan bir temsilci sağlamanıza olanak tanır. Temsilcide, önbelleğe alınan öğeyi güncelleştirebilir ve böylece önbellekten kaldırılmasını önleyebilirsiniz.

Bu yöntem, aynı Cache parametreye sahip mevcut key bir öğenin üzerine yazar.

Önbellek öğesinin, öğeye son erişildikten sonraki belirli bir süre sonunda süresinin dolmasına niyetliyseniz, parametresini süre sonu aralığına ayarlarsınız slidingExpiration ve parametresini absoluteExpiration olarak NoAbsoluteExpirationayarlarsınız.

Ayrıca bkz.

CacheItemUpdateCallback

Şunlara uygulanır

Insert(String, Object, CacheDependency)

dosyasına dosya veya anahtar bağımlılıkları olan bir nesne Cache ekler.

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)

Parametreler

key: String

Öğeyi tanımlamak için kullanılan önbellek anahtarı.

value: Object

Önbelleğe eklenecek nesne.

dependencies: CacheDependency

Eklenen nesne için dosya veya önbellek anahtarı bağımlılıkları. Herhangi bir bağımlılık değiştiğinde, nesne geçersiz hale gelir ve önbellekten kaldırılır. Bağımlılık yoksa, bu parametre içerir null.

Özel durumlar

ArgumentNullException

key veya value parametresidirnull.

Örnekler

Aşağıdaki örnek, XML yapılandırma dosyasına önbellek bağımlılığıyla bir öğenin uygulamanın önbelleğine nasıl ekleyebileceğinizi gösterir.

Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));

Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))

Açıklamalar

Bu yöntem, anahtarı parametresiyle eşleşen mevcut bir önbellek öğesinin key üzerine yazar. yönteminin bu aşırı yüklemesini Insert kullanarak önbelleğe eklenen nesne, önceliğe, kayan Defaultsüre sonu değeri NoSlidingExpirationve mutlak süre sonu değeri NoAbsoluteExpirationile eklenir.

Ayrıca bkz.

CacheDependency

Şunlara uygulanır

Insert(String, Object)

Sabit listesi tarafından sağlanan varsayılan değerleri kullanarak konumuna başvurmak için nesneye Cache önbellek anahtarıyla bir öğe CacheItemPriority ekler.

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)

Parametreler

key: String

Öğeye başvurmak için kullanılan önbellek anahtarı.

value: Object

Önbelleğe eklenecek nesne.

Özel durumlar

ArgumentNullException

key veya value parametresidirnull.

Örnekler

Aşağıdaki örnek, bir öğenin uygulamanın önbelleğine nasıl ekleyebileceğinizi gösterir.

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

Açıklamalar

Bu yöntem, anahtarı parametresiyle eşleşen mevcut bir önbellek öğesinin key üzerine yazar. yönteminin bu aşırı yüklemesini Insert kullanarak önbelleğe eklenen nesne, dosya veya önbellek bağımlılıkları olmadan, önceliği , kayan Defaultsüre sonu değeri NoSlidingExpirationve mutlak süre sonu değeri NoAbsoluteExpirationile eklenir.

Ayrıca bkz.

Uygulama Verilerini Önbelleğe Alma

Şunlara uygulanır

Insert(String, Object, CacheDependency, DateTime, TimeSpan)

bağımlılıkları ve süre sonu ilkeleriyle içine Cache bir nesne ekler.

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)

Parametreler

key: String

Nesneye başvurmak için kullanılan önbellek anahtarı.

value: Object

Önbelleğe eklenecek nesne.

dependencies: CacheDependency

absoluteExpiration: DateTime

slidingExpiration: TimeSpan

Eklenen nesnenin son erişildiği zaman ile bu nesnenin süresinin dolma zamanı arasındaki zaman aralığı. Bu değer 20 dakikanın eşdeğeriyse, nesnenin süresi dolar ve son erişildikten 20 dakika sonra önbellekten kaldırılır. Kayan süre sonu kullanıyorsanız parametresi absoluteExpiration olmalıdır NoAbsoluteExpiration.

Özel durumlar

ArgumentNullException

key veya value parametresidirnull.

ArgumentOutOfRangeException

parametresini slidingExpiration bir yıldan küçük TimeSpan.Zero veya eşdeğeri olarak ayarlarsınız.

ArgumentException

ve parametrelerinin absoluteExpiration her ikisi de öğesine eklemeye çalıştığınız öğe için ayarlanmıştırslidingExpiration.Cache

Örnekler

Aşağıdaki örnek, mutlak süre sonuyla bir öğenin uygulamanın önbelleğine nasıl ekleyebileceğinizi gösterir.

Note

Insert yönteminin bu biçimi önbellek bağımlılıklarını desteklediğinden, öğenin bağımlılıkları yoksa, dependency parametresini virgülle ayrılmış parametre listesinde null (Visual Basic'de Nothing) olarak bildirmeniz gerekir.

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);

Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)

Aşağıdaki örnek, kayan süre sonu ile önbelleğe bir öğenin nasıl ekleyebileceğinizi gösterir.

Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));

Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))

Açıklamalar

Bu yöntem, aynı Cache parametreye sahip mevcut key bir öğenin üzerine yazar.

parametresi olarak ayarlanırsa slidingExpirationkayan NoSlidingExpiration süre sonu devre dışı bırakılır. parametresini değerinden slidingExpirationZeroabsoluteExpiration büyük olarak ayarlarsanız, parametresi artı parametresinde Now bulunan değer olarak slidingExpiration ayarlanır. Öğe, parametre tarafından absoluteExpiration belirtilen süreden önce önbellekten istenirse, öğe yeniden önbelleğe yerleştirilir ve absoluteExpiration yine parametresinde DateTime.Now bulunan değere slidingExpiration ayarlanır. Öğe, parametredeki tarihten absoluteExpiration önce önbellekten istenmezse, öğe önbellekten kaldırılır. Insert yönteminin bu aşırı yüklemesi kullanılarak önbelleğe eklenen öğe, önceliğe Defaultsahip olarak eklenir.

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?