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

Önbelleğe bir önbellek girdisi ekler.

Aşırı Yüklemeler

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 bir ö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 giriş yoksa oluşturulur. Belirtilen giriş varsa, güncelleştirilir.

Set(CacheItem, CacheItemPolicy)

Ö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 değeridir.

-veya-

Key özelliğidirnull.

-veya-

Value özelliğidirnull.

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 NoSlidingExpiration alanlarının varsayılanları InfiniteAbsoluteExpiration 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 NoSlidingExpiration özelliği olarak InfiniteAbsoluteExpiration ayarlanmalıdır.

• Nesne için CacheItemPolicy hem kaldırma geri çağırması hem de güncelleştirme geri çağırması 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 küçük Zerobir 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 her zaman önbelleğe bir önbellek değeri yerleştirir. Belirtilen girdi önbellekte yoksa yeni bir önbellek girdisi eklenir. Belirtilen giriş zaten varsa, değeri güncelleştirilir.

Set(String, Object, DateTimeOffset, String)

Bir anahtar ve değer kullanarak önbelleğe bir ö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 girdisinin benzersiz tanımlayıcısı.

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 MemoryCache bu parametre null varsayılan olarak kullanılır.

Özel durumlar

NotSupportedException

regionName değildir null.

ArgumentNullException

key, null değeridir.

-veya-

Value, null değeridir.

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 NoSlidingExpirationvarsayılanları InfiniteAbsoluteExpiration 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 NoSlidingExpirationolarak InfiniteAbsoluteExpiration 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 küçük Zerobir 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 her zaman önbelleğe bir önbellek değeri yerleştirir. Belirtilen giriş yoksa, yeni bir önbellek girdisi eklenir. Belirtilen giriş varsa, güncelleştirilir.

absoluteExpiration parametresi, 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)

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 girdisinin benzersiz tanımlayıcısı.

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 MemoryCache bu parametre null varsayılan olarak kullanılır.

Özel durumlar

ArgumentNullException

key, null değeridir.

-veya-

value null

-veya-

özelliğindeki yardımcı yöntemine UpdateCallback geçirilen geri çağırma başvurusu şeklindedir 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 NoSlidingExpirationvarsayılanları InfiniteAbsoluteExpiration 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 NoSlidingExpirationolarak InfiniteAbsoluteExpiration ayarlanmalıdır.

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

ArgumentOutOfRangeException

SlidingExpiration özelliği değerinden küçük Zerobir 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ğildir null.

Açıklamalar

Diğer Set yöntem aşırı yüklemelerinde olduğu gibi yöntemi de Set eşleşen bir girdinin mevcut olup olmadığına bakılmaksızın her zaman önbellek değerini önbelleğe yerleştirir. Belirtilen girdi önbellekte yoksa yeni bir önbellek girdisi eklenir. Belirtilen giriş 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.