共用方式為


MemoryCache.Set 方法

定義

將快取項目插入快取區中。

多載

Set(CacheItem, CacheItemPolicy)

使用 CacheItem 執行個體提供快取項目所需的索引鍵和值,以在快取中插入快取項目。

Set(String, Object, DateTimeOffset, String)

使用索引鍵、值並指定以時間為基礎的到期詳細資訊,在快取區中插入快取項目。

Set(String, Object, CacheItemPolicy, String)

使用索引鍵、值和清除,在快取區中插入快取項目。

備註

如果指定的專案不存在,則會建立它。 如果指定的專案存在,則會更新它。

Set(CacheItem, CacheItemPolicy)

來源:
MemoryCache.cs
來源:
MemoryCache.cs
來源:
MemoryCache.cs
來源:
MemoryCache.cs
來源:
MemoryCache.cs

使用 CacheItem 執行個體提供快取項目所需的索引鍵和值,以在快取中插入快取項目。

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)

參數

item
CacheItem

物件,表示要插入的快取項目。

policy
CacheItemPolicy

物件,包含快取項目的收回詳細資料。 這個物件提供的收回選項比簡單絕對期限要多。

例外狀況

itemnull

-或-

Key 屬性為 null

-或-

Value 屬性為 null

傳遞的快取項目引數組合無效。 如果在快取項目的原則物件上設定下列期限詳細資料,就會發生這個狀況:

SlidingExpiration 屬性設定為小於 Zero 的值。

-或-

SlidingExpiration 屬性設定為大於一年的値。

-或-

Priority 不是 CacheItemPriority 列舉的值。

備註

如同其他 Set 方法多載, Set 方法一律會將快取值放在快取中,不論專案是否已經存在具有相同索引鍵。 如果快取中沒有指定的專案,則會插入新的快取專案。 如果指定的項目已經存在,則會更新其值。

適用於

Set(String, Object, DateTimeOffset, String)

來源:
MemoryCache.cs
來源:
MemoryCache.cs
來源:
MemoryCache.cs
來源:
MemoryCache.cs
來源:
MemoryCache.cs

使用索引鍵、值並指定以時間為基礎的到期詳細資訊,在快取區中插入快取項目。

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)

參數

key
String

要插入之快取項目的唯一識別項。

value
Object

快取項目的資料。

absoluteExpiration
DateTimeOffset

快取項目到期的固定日期和時間。

regionName
String

快取區中的具名區域,快取項目可以加入至這個區域。 請勿傳遞這個參數的值。 這個參數預設為 null,因為 MemoryCache 類別沒有實作區域。

例外狀況

regionName 不是 null

keynull

-或-

Valuenull

SlidingExpiration 屬性設定為小於 Zero 的值。

-或-

SlidingExpiration 屬性設定為大於一年的値。

-或-

備註

如同其他 Set 方法多載, Set 方法一律會將快取值放在快取中,而不論專案是否已經存在具有相同索引鍵。 如果指定的專案不存在,則會插入新的快取專案。 如果指定的專案存在,則會更新它。

參數 absoluteExpiration 會指出何時應該從快取中移除專案。

拿掉專案會觸發任何相關聯的變更監視器。 如果移除的專案與 CacheItemUpdateCallback 對象或 CacheItemRemovedCallback 對象相關聯,則傳遞給回呼的移除原因會包含在屬性中 Removed

適用於

Set(String, Object, CacheItemPolicy, String)

來源:
MemoryCache.cs
來源:
MemoryCache.cs
來源:
MemoryCache.cs
來源:
MemoryCache.cs
來源:
MemoryCache.cs

使用索引鍵、值和清除,在快取區中插入快取項目。

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)

參數

key
String

要插入之快取項目的唯一識別項。

value
Object

快取項目的資料。

policy
CacheItemPolicy

物件,包含快取項目的收回詳細資料。 這個物件提供的收回選項比簡單絕對期限要多。

regionName
String

快取區中的具名區域,快取項目可以加入至這個區域。 請勿傳遞這個參數的值。 這個參數預設為 null,因為 MemoryCache 類別沒有實作區域。

例外狀況

keynull

-或-

valuenull

-或-

UpdateCallback 屬性中傳遞至 Helper 方法的回呼參考為 null

SlidingExpiration 屬性設定為小於 Zero 的值。

-或-

SlidingExpiration 屬性設定為大於一年的値。

-或-

Priority 屬性不是 CacheItemPriority 列舉的值。

regionName 不是 null

備註

如同其他 Set 方法多載, Set 方法一律會將快取值放在快取中,而不論相符的專案是否已存在。 如果快取中沒有指定的專案,則會插入新的快取專案。 如果指定的專案存在,則會更新它。

拿掉專案會觸發任何相關聯的變更監視器。 如果移除的專案與 CacheItemUpdateCallback 對象或 CacheItemRemovedCallback 對象相關聯,則傳遞給回呼的移除原因會包含在屬性中 Removed

適用於