Aracılığıyla paylaş


ObjectCache.Add Yöntem

Tanım

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
Kaynak:
ObjectCache.cs
Kaynak:
ObjectCache.cs
Kaynak:
ObjectCache.cs
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

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 .

Şunlara uygulanır

Add(String, Object, DateTimeOffset, String)

Kaynak:
ObjectCache.cs
Kaynak:
ObjectCache.cs
Kaynak:
ObjectCache.cs
Kaynak:
ObjectCache.cs
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

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 .

Şunlara uygulanır

Add(String, Object, CacheItemPolicy, String)

Kaynak:
ObjectCache.cs
Kaynak:
ObjectCache.cs
Kaynak:
ObjectCache.cs
Kaynak:
ObjectCache.cs
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

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 .

Şunlara uygulanır