Aracılığıyla paylaş


MemoryCache.Set Yöntem

Tanım

Ö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)

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

item, null değeridir.

-veya-

Key özelliğidirnull.

-veya-

Value özelliğidirnull.

Ö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:

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.

Şunlara uygulanır

Set(String, Object, DateTimeOffset, String)

Kaynak:
MemoryCache.cs
Kaynak:
MemoryCache.cs
Kaynak:
MemoryCache.cs
Kaynak:
MemoryCache.cs
Kaynak:
MemoryCache.cs

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

regionName değildir null.

key, null değeridir.

-veya-

Value, null değeridir.

  • Ö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.

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-

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.

Şunlara uygulanır

Set(String, Object, CacheItemPolicy, String)

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

key, null değeridir.

-veya-

value null

-veya-

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

  • Ö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.

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.

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.

Şunlara uygulanır