Cache.Insert Yöntem

Tanım

Ad Alanı:

System.Web.Caching

Bütünleştirilmiş Kod:

System.Web.dll

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

Aşırı Yüklemeler

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)	Nesnesine Cache bağımlılıkları, süre sonu ve öncelik ilkeleri ve eklenen öğe öğesi öğesinden Cachekaldırıldığında uygulamanızı bilgilendirmek için kullanabileceğiniz bir temsilci içeren bir nesne 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 bir önbellek anahtarıyla nesneye CacheItemPriority bir öğe Cache 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 ilkeleri ve eklenen öğe öğesi öğesinden Cachekaldırıldığında uygulamanızı bilgilendirmek için kullanabileceğiniz bir temsilci içeren bir nesne 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 saatle yaz saati arasında değişiklik gibi yerel saatle ilgili olası sorunları önlemek için bu parametre değeri yerine Now kullanınUtcNow. 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 dolması 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.

priority

CacheItemPriority

Sabit listesi tarafından ifade edildiği gibi, önbellekte depolanan diğer öğelere göre nesnenin CacheItemPriority maliyeti. Bu değer önbellek tarafından nesneleri çıkardığında 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ırCache.slidingExpiration

Örnekler

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

Not

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 Bir Uygulamayı Bilgilendirme.

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ı key parametreye sahip mevcut Cache bir öğenin üzerine yazar.

hem hem slidingExpiration de absoluteExpiration parametrelerini ayarlayamazsınız. Önbellek öğesinin belirli bir zamanda süresinin dolmasına karar verirseniz, parametresini absoluteExpiration belirli bir saate, parametresini slidingExpiration ise 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 absoluteExpiration olarak NoAbsoluteExpirationayarlarsınızslidingExpiration.

Ayrıca bkz.

• DateTime
• TimeSpan
• CacheItemPriority
• CacheItemRemovedCallback
• Uygulama Verilerini Önbelleğe Alma

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

Öğ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. Yerel saatle ilgili olası sorunları önlemek için (örneğin, standart saatten yaz saati saatine yapılan değişiklikler) bu parametre değeri yerine Now kullanınUtcNow. Mutlak süre sonu kullanıyorsanız parametresi olarak slidingExpiration ayarlanmalıdır NoSlidingExpiration.

slidingExpiration

TimeSpan

Önbelleğe alınan nesnenin en son erişildiği saat 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 olarak absoluteExpiration ayarlanmalıdır NoAbsoluteExpiration.

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 parametresi şeklindedirnull.

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ırCache.slidingExpiration

-veya-

dependencies parametresi , nullparametresi absoluteExpiration ise olarak, NoAbsoluteExpirationslidingExpiration parametresi ise olarak NoSlidingExpirationayarlanır.

Açıklamalar

yöntemi, Insert ö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ı key parametreye sahip mevcut Cache bir öğenin üzerine yazar.

hem hem slidingExpiration de absoluteExpiration parametrelerini ayarlayamazsınız. Önbellek öğesinin belirli bir zamanda süresinin dolmasına karar verirseniz, parametresini absoluteExpiration belirli bir saate, parametresini slidingExpiration ise olarak NoSlidingExpirationayarlarsınız.

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

Ayrıca bkz.

• CacheItemUpdateCallback

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 örnekte, xml yapılandırma dosyasına önbellek bağımlılığı olan bir uygulamanın önbelleğine nasıl öğe ekleyebileceğiniz gösterilmektedir.

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ği , kayan Defaultsüre sonu değeri NoSlidingExpirationve mutlak süre sonu değeri NoAbsoluteExpirationile eklenir.

Ayrıca bkz.

• CacheDependency

Insert(String, Object)

Sabit listesi tarafından sağlanan varsayılan değerleri kullanarak konumuna başvurmak için bir önbellek anahtarıyla nesneye CacheItemPriority bir öğe Cache 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 DefaultNoSlidingExpirationsüre sonu değeri ve mutlak süre sonu değeri NoAbsoluteExpirationile eklenir.

Ayrıca bkz.

• Uygulama Verilerini Önbelleğe Alma

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

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.

absoluteExpiration

DateTime

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

slidingExpiration

TimeSpan

Eklenen nesnenin son erişildiği zaman ile 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.

Ö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ırCache.slidingExpiration

Örnekler

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

Not

Yöntemin Insert bu biçimi önbellek bağımlılıklarını desteklediğinden, öğenin bağımlılıkları yoksa parametreyi dependency virgülle ayrılmış parametre listesinde (Nothing Visual Basic'te) olarak null 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 örnekte, kayan süre sonuyla önbelleğe bir öğenin nasıl ekleyebileceğiniz gösterilmektedir.

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ı key parametreye sahip mevcut Cache bir öğenin üzerine yazar.

slidingExpiration parametresi olarak ayarlanırsaNoSlidingExpiration, kayan süre sonu devre dışı bırakılır. parametresini değerinden slidingExpirationZeroabsoluteExpiration büyük olarak ayarlarsanız parametresi, parametresinde slidingExpiration bulunan değere artı olarak ayarlanırNow. Öğe, parametresi tarafından absoluteExpiration belirtilen süreden önce önbellekten istenirse, öğe yeniden önbelleğe yerleştirilir ve absoluteExpiration tekrar parametresinde slidingExpiration bulunan değere DateTime.Now 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.

• DateTime
• TimeSpan
• Uygulama Verilerini Önbelleğe Alma