Cache.Insert Yöntem
Tanım
Ö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ı 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 |
| 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 -> unitPublic 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
key veya value parametresidirnull.
parametresini slidingExpiration bir yıldan küçük TimeSpan.Zero veya eşdeğeri olarak ayarlarsınız.
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.
Ş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 -> unitPublic 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
key, valueveya onUpdateCallback parametresi şeklindedirnull.
parametresini slidingExpiration bir yıldan küçük TimeSpan.Zero veya eşdeğeri olarak ayarlarsınız.
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.
Ş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 -> unitPublic 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
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.
Şunlara uygulanır
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 -> unitPublic 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
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.
Ş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 -> unitPublic 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
key veya value parametresidirnull.
parametresini slidingExpiration bir yıldan küçük TimeSpan.Zero veya eşdeğeri olarak ayarlarsınız.
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.
