MemoryCache.Set 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

Önbelleğe bir önbellek girdisi ekler.

Aşırı Yüklemeler

Name	Description
Set(CacheItem, CacheItemPolicy)	Önbellek girdisinin anahtarını ve değerini sağlamak için bir CacheItem örnek kullanarak önbelleğe bir önbellek girdisi ekler.
Set(String, Object, DateTimeOffset, String)	Bir anahtar ve değer kullanarak önbelleğe önbellek girdisi ekler ve zamana bağlı süre sonu ayrıntılarını belirtir.
Set(String, Object, CacheItemPolicy, String)	Bir anahtar, bir değer ve çıkarma kullanarak önbelleğe bir önbellek girdisi ekler.

Açıklamalar

Belirtilen girdi yoksa oluşturulur. Belirtilen girdi varsa, güncelleştirilir.

Set(CacheItem, CacheItemPolicy)

Kaynak:

MemoryCache.cs

Önbellek girdisinin anahtarını ve değerini sağlamak için bir CacheItem örnek kullanarak önbelleğe bir önbellek girdisi ekler.

public:
 override void Set(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public override void Set(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

override this.Set : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> unit

Public Overrides Sub Set (item As CacheItem, policy As CacheItemPolicy)

Parametreler

item

CacheItem

Eklenecek önbellek girdisini temsil eden 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.

Özel durumlar

ArgumentNullException

item, null'e eşittir.

-veya-

Key özelliği null.

-veya-

Value özelliği null.

ArgumentException

Önbellek girdisi için geçersiz bir bağımsız değişken bileşimi geçirildi. Önbellek girdisi için ilke nesnesinde aşağıdaki süre sonu ayrıntıları ayarlanırsa bu durum oluşur:

• Nesnenin hem mutlak hem de kayan CacheItemPolicy süre sonu değerleri ve InfiniteAbsoluteExpiration alanlarının varsayılan değerleri NoSlidingExpiration dışında değerlere ayarlanırsa. Sınıfı, MemoryCache hem mutlak süre sonu hem de kayan süre sonu temelinde süre sonu ilkesi ayarlayamaz. sınıfını kullandığınızda MemoryCache yalnızca bir süre sonu ayarı açıkça ayarlanabilir. Diğer ayar veya InfiniteAbsoluteExpiration özelliği olarak NoSlidingExpiration ayarlanmalıdır.

• Nesne için CacheItemPolicy hem kaldırma geri çağırması hem de güncelleştirme geri çağrısı belirtilirse. MemoryCache sınıfı, önbellek girdisi başına yalnızca bir geri çağırma türü kullanmayı destekler.

ArgumentOutOfRangeException

SlidingExpiration özelliği değerinden Zeroküçük bir değere ayarlanır.

-veya-

SlidingExpiration özelliği bir yıldan büyük bir değere ayarlanır.

-veya-

Priority sabit listesi değeri CacheItemPriority değildir.

Açıklamalar

Diğer Set yöntem aşırı yüklemelerinde olduğu gibi yöntemi Set de aynı anahtara sahip bir girdi olup olmadığına bakılmaksızın önbellekte her zaman bir önbellek değeri koyar. Belirtilen girdi önbellekte yoksa, yeni bir önbellek girdisi eklenir. Belirtilen girdi zaten varsa, değeri güncelleştirilir.

Set(String, Object, DateTimeOffset, String)

Kaynak:

MemoryCache.cs

Bir anahtar ve değer kullanarak önbelleğe önbellek girdisi ekler ve zamana bağlı süre sonu ayrıntılarını belirtir.

public override void Set(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

override this.Set : string * obj * DateTimeOffset * string -> unit

Public Overrides Sub Set (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing)

Parametreler

key

String

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

value

Object

Önbellek girdisinin verileri.

absoluteExpiration

DateTimeOffset

Önbellek girişinin süresinin dolacağı sabit tarih ve saat.

regionName

String

Önbellekte, önbellek girişinin eklenebileceği adlandırılmış bölge. Bu parametre için bir değer geçirmeyin. Sınıfı bölgeleri uygulamadığından null bu parametre MemoryCache varsayılan olarak kullanılır.

Özel durumlar

NotSupportedException

regionName değil null.

ArgumentNullException

key, null'e eşittir.

-veya-

value, null'e eşittir.

ArgumentException

• Önbellek girdisi için geçersiz bir bağımsız değişken bileşimi geçirildi. Önbellek girdisi için ilke nesnesinde aşağıdaki süre sonu ayrıntıları ayarlanırsa bu durum oluşur:

• Nesnedeki hem mutlak hem de kayan süre sonu değerleri CacheItemPolicy ve InfiniteAbsoluteExpirationvarsayılan değerleri NoSlidingExpiration dışında değerlere ayarlanırsa. Bunun nedeni, sınıfın hem mutlak hem de kayan MemoryCache süre sonu temelinde süresi dolan girişleri desteklememesidir. sınıfını kullandığınızda MemoryCache yalnızca bir süre sonu ayarı açıkça ayarlanabilir. Diğer ayar veya InfiniteAbsoluteExpirationolarak NoSlidingExpiration ayarlanmalıdır.

• Nesnede hem kaldırma geri çağırması hem de güncelleştirme geri çağırması belirtilirse CacheItemPolicy . MemoryCache sınıfı, önbellek girdisi başına yalnızca bir geri çağırma türü kullanmayı destekler.

ArgumentOutOfRangeException

SlidingExpiration özelliği değerinden Zeroküçük bir değere ayarlanır.

-veya-

SlidingExpiration özelliği bir yıldan büyük bir değere ayarlanır.

-veya-

• Priority özelliği sabit listesi değeri CacheItemPriority değildir.

Açıklamalar

Diğer Set yöntem aşırı yüklemelerinde olduğu gibi yöntemi Set de aynı anahtara sahip bir girdi olup olmadığına bakılmaksızın önbellekte her zaman bir önbellek değeri koyar. Belirtilen girdi yoksa, yeni bir önbellek girdisi eklenir. Belirtilen girdi varsa, güncelleştirilir.

parametresi, absoluteExpiration girdinin önbellekten ne zaman kaldırılması gerektiğini gösterir.

Bir girişin kaldırılması, ilişkili değişiklik izleyicilerini tetikler. Kaldırılan öğe bir CacheItemUpdateCallback nesne veya CacheItemRemovedCallback nesneyle ilişkilendirildiyse, geri çağırmalara geçirilen kaldırma nedeni özelliğinde Removed yer alır.

Set(String, Object, CacheItemPolicy, String)

Kaynak:

MemoryCache.cs

Bir anahtar, bir değer ve çıkarma kullanarak önbelleğe bir önbellek girdisi ekler.

public override void Set(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

override this.Set : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> unit

Public Overrides Sub Set (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing)

Parametreler

key

String

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

value

Object

Önbellek girdisinin verileri.

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

Önbellekte, önbellek girişinin eklenebileceği adlandırılmış bölge. Bu parametre için bir değer geçirmeyin. Sınıfı bölgeleri uygulamadığından null bu parametre MemoryCache varsayılan olarak kullanılır.

Özel durumlar

ArgumentNullException

key, null'e eşittir.

-veya-

value eşittir null

-veya-

özelliğindeki yardımcı yöntemine UpdateCallback geçirilen geri çağırma başvurusudur null.

ArgumentException

• Önbellek girdisi için geçersiz bir bağımsız değişken bileşimi var. Önbellek girdisi için ilke nesnesinde aşağıdaki süre sonu ayrıntıları ayarlanırsa bu durum oluşur:

• Nesnedeki hem mutlak hem de kayan süre sonu değerleri CacheItemPolicy ve InfiniteAbsoluteExpirationvarsayılan değerleri NoSlidingExpiration dışında değerlere ayarlanırsa. Bunun nedeni, sınıfın hem mutlak hem de kayan MemoryCache süre sonu temelinde süresi dolan girişleri desteklememesidir. sınıfını kullandığınızda MemoryCache yalnızca bir süre sonu ayarı açıkça ayarlanabilir. Diğer ayar veya InfiniteAbsoluteExpirationolarak NoSlidingExpiration ayarlanmalıdır.

• Hem kaldırma geri çağırması hem de güncelleştirme geri çağırması sınıfında belirtilirse CacheItemPolicy . MemoryCache sınıfı, önbellek girdisi başına yalnızca bir geri çağırma türü kullanmayı destekler.

ArgumentOutOfRangeException

SlidingExpiration özelliği değerinden Zeroküçük bir değere ayarlanır.

-veya-

SlidingExpiration özelliği bir yıldan büyük bir değere ayarlanır.

-veya-

Priority özelliği sabit listesi değeri CacheItemPriority değildir.

NotSupportedException

regionName değil null.

Açıklamalar

Diğer Set yöntem aşırı yüklemelerinde olduğu gibi yöntemi de Set eşleşen bir girişin mevcut olup olmadığına bakılmaksızın önbellekte her zaman bir önbellek değeri koyar. Belirtilen girdi önbellekte yoksa, yeni bir önbellek girdisi eklenir. Belirtilen girdi varsa, güncelleştirilir.

Bir girişin kaldırılması, ilişkili değişiklik izleyicilerini tetikler. Kaldırılan öğe bir CacheItemUpdateCallback nesne veya CacheItemRemovedCallback nesneyle ilişkilendirildiyse, geri çağırmalara geçirilen kaldırma nedeni özelliğinde Removed yer alır.