ObjectCache.Add Yöntem

Tanım

Ad Alanı:

System.Runtime.Caching

Bütünleştirilmiş Kod:

System.Runtime.Caching.dll

Paket:

System.Runtime.Caching v11.0.0-preview.4.26230.115

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

Name	Description
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ılacağıyla 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

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

Yöntem AddOrGetExisting 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 girişine ihtiyaç duyana göre kodlarını iyileştirmesine olanak tanır. Dağıtılmış önbelleklerde, yöntemini kullanarak mevcut bir değeri döndürmek, yöntemi kullanarak AddOrGetExistingAdd 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ılacağıyla 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 zaten varsa.

Açıklamalar

Add yöntemi iç olarak çağırdığından ObjectCacheAdd, yöntemi aşırı yüklemeleri sınıfta sanaldır (soyut AddOrGetExisting 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ış gerektirmediyse, 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öntemi çağrıldığında Add bu parametre gereklidir.

regionName

String

Optional. 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 null'dir.

Döndürülenler

Boolean

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

Açıklamalar

Add yöntemi iç olarak çağırdığından ObjectCacheAdd, yöntemi aşırı yüklemeleri sınıfta sanaldır (soyut AddOrGetExisting 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ış gerektirmediyse, 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

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

Döndürülenler

Boolean

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

Açıklamalar

Add yöntemi iç olarak çağırdığından ObjectCacheAdd, yöntemi aşırı yüklemeleri sınıfta sanaldır (soyut AddOrGetExisting 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ış gerektirmediyse, yalnızca yöntem aşırı yüklemelerini uygulayabilir AddOrGetExisting .