ObjectCache.Add Yöntem

Tanım

Ad Alanı:

System.Runtime.Caching

Bütünleştirilmiş Kod:

System.Runtime.Caching.dll

Paket:

System.Runtime.Caching v9.0.0-preview.4.24266.19

Türetilmiş bir sınıfta geçersiz kılındığında, eşleşen anahtara sahip mevcut bir önbellek girişinin döndürülmesi gerekmeden önbelleğe bir önbellek girdisi ekler.

Aşırı Yüklemeler

Add(CacheItem, CacheItemPolicy)	Türetilmiş bir sınıfta geçersiz kılındığında, önbelleğe örnek olarak CacheItem bir önbellek girdisi eklemeyi dener ve girdinin nasıl çıkarılması gerektiğiyle ilgili ayrıntılar ekler.
Add(String, Object, DateTimeOffset, String)	Türetilmiş bir sınıfta geçersiz kılındığında, var olan önbellek girdilerinin üzerine yazmadan önbelleğe bir önbellek girdisi ekler.
Add(String, Object, CacheItemPolicy, String)	Türetilmiş bir sınıfta geçersiz kılındığında, önbelleğe bir önbellek girdisi ekler ve girdinin nasıl çıkarılacağı hakkında bilgi belirtir.

Açıklamalar

Yöntem Add aşırı yüklemeleri, aynı anahtara sahip mevcut bir önbellek girişinin üzerine yazmadan veya kaldırmadan önbelleğe bir önbellek girdisi eklemeye çalışır. Önbellek girdisi, yazılan CacheItem bir nesne veya genel bir nesne olabilir.

AddOrGetExisting Yöntem aşırı yüklemeleri ve Add yöntem aşırı yüklemelerinin önemli bir farkı vardır. Bu yöntemler önbellek girdisi eklediğinde, önbellekte eşleşen bir giriş bulunursa, AddOrGetExisting yöntem aşırı yüklemeleri mevcut önbellek girdisini döndürür, ancak Add yöntem aşırı yüklemeleri döndürmez. Bu farklı yöntem aşırı yüklemelerine sahip olmak, çağıranların mevcut önbellek girdisine ihtiyaç duyana göre kodlarını iyileştirmesine olanak tanır. Dağıtılmış önbelleklerde, yöntemini kullanarak var olan bir değeri döndürmek AddOrGetExisting , yöntemi kullanarak Add Boole değeri döndürmekten daha pahalı olabilir.

Add(CacheItem, CacheItemPolicy)

Kaynak:

ObjectCache.cs

Türetilmiş bir sınıfta geçersiz kılındığında, önbelleğe örnek olarak CacheItem bir önbellek girdisi eklemeyi dener ve girdinin nasıl çıkarılması gerektiğiyle ilgili ayrıntılar ekler.

public:
 virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public virtual bool Add (System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool

Public Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean

Parametreler

item

CacheItem

Eklenecek nesne.

policy

CacheItemPolicy

Önbellek girdisi için çıkarma ayrıntılarını içeren bir nesne. Bu nesne, çıkarma için basit bir mutlak süre sonu yerine daha fazla seçenek sağlar.

Döndürülenler

Boolean

true ekleme başarılı olduysa veya false önbellekte ile aynı anahtara itemsahip bir girdi varsa.

Açıklamalar

Add Yöntemin dahili olarak çağrısından AddOrGetExistingdolayı Add yöntemi aşırı yüklemeleri sınıfta sanaldır (soyut ObjectCache değildir). Bu, önbellek uygulayıcısının sağlaması gereken yöntem aşırı yüklemelerinin sayısını azaltır. Önbellek uygulaması yöntem için Add özel bir davranış gerektirmiyorsa, yalnızca yöntem aşırı yüklemelerini uygulayabilir AddOrGetExisting .

Add(String, Object, DateTimeOffset, String)

Kaynak:

ObjectCache.cs

Türetilmiş bir sınıfta geçersiz kılındığında, var olan önbellek girdilerinin üzerine yazmadan önbelleğe bir önbellek girdisi ekler.

public virtual bool Add (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> bool

Public Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Boolean

Parametreler

key

String

Önbellek girdisi için benzersiz bir tanımlayıcı.

value

Object

Eklenecek nesne.

absoluteExpiration

DateTimeOffset

Önbellek girişinin süresinin dolacağı sabit tarih ve saat. Yöntem çağrıldığında Add bu parametre gereklidir.

regionName

String

İsteğe bağlı. Bölgeler uygulandıysa önbellek girdisinin eklenebileceği önbellekteki adlandırılmış bölge. Bölgeler .NET Framework 4'te uygulanmadığından varsayılan değer olurnull.

Döndürülenler

Boolean

true ekleme başarılı olduysa veya false önbellekte ile aynı anahtara keysahip bir girdi varsa.

Açıklamalar

Add Yöntemin dahili olarak çağrısından AddOrGetExistingdolayı Add yöntemi aşırı yüklemeleri sınıfta sanaldır (soyut ObjectCache değildir). Bu, önbellek uygulayıcısının sağlaması gereken yöntem aşırı yüklemelerinin sayısını azaltır. Önbellek uygulaması yöntem için Add özel bir davranış gerektirmiyorsa, yalnızca yöntem aşırı yüklemelerini uygulayabilir AddOrGetExisting .

Add(String, Object, CacheItemPolicy, String)

Kaynak:

ObjectCache.cs

Türetilmiş bir sınıfta geçersiz kılındığında, önbelleğe bir önbellek girdisi ekler ve girdinin nasıl çıkarılacağı hakkında bilgi belirtir.

public virtual bool Add (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool

Public Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Boolean

Parametreler

key

String

Önbellek girdisi için benzersiz bir tanımlayıcı.

value

Object

Eklenecek nesne.

policy

CacheItemPolicy

Önbellek girdisi için çıkarma ayrıntılarını içeren bir nesne. Bu nesne, çıkarma için basit bir mutlak süre sonu yerine daha fazla seçenek sağlar.

regionName

String

İsteğe bağlı. Bölgeler uygulandıysa önbellek girdisinin eklenebileceği önbellekteki adlandırılmış bölge. İsteğe bağlı parametrenin varsayılan değeri şeklindedir null.

Döndürülenler

Boolean

true ekleme başarılı olursa veya false önbellekte ile aynı anahtara keysahip bir girdi varsa.

Açıklamalar

Add Yöntemin dahili olarak çağrısından AddOrGetExistingdolayı Add yöntemi aşırı yüklemeleri sınıfta sanaldır (soyut ObjectCache değildir). Bu, önbellek uygulayıcısının sağlaması gereken yöntem aşırı yüklemelerinin sayısını azaltır. Önbellek uygulaması yöntem için Add özel bir davranış gerektirmiyorsa, yalnızca yöntem aşırı yüklemelerini uygulayabilir AddOrGetExisting .