ObjectCache.Set 方法

參考

定義

命名空間:: System.Runtime.Caching

組件:: System.Runtime.Caching.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在衍生類別中遭覆寫時，在快取區中插入快取項目。

多載

Set(CacheItem, CacheItemPolicy)	在衍生類別中遭覆寫時，在快取中插入快取項目做為 CacheItem 執行個體，並指定關於要如何收回項目的資訊。
Set(String, Object, DateTimeOffset, String)	在衍生類別中遭覆寫時，在快取中插入快取項目，並指定以時間為基礎的到期詳細資訊。
Set(String, Object, CacheItemPolicy, String)	在衍生類別中遭覆寫時，在快取區中插入快取項目。

備註

多載方法的 Set 一般行為是插入或更新作業。如果指定的專案不存在，快取專案會插入為新專案，或者如果快取專案已經存在，則會以新的值更新快取專案。

Set(CacheItem, CacheItemPolicy)

在衍生類別中遭覆寫時，在快取中插入快取項目做為 CacheItem 執行個體，並指定關於要如何收回項目的資訊。

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

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

abstract member Set : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> unit

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

參數

item: CacheItem

要加入的快取項目。

policy: CacheItemPolicy

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

備註

如果的 item 索引鍵不存在， item 則會插入為新的快取專案。如果具有符合 item 索引鍵的專案存在，則會使用中的 item 值來更新或覆寫現有快取專案的值。

適用於

Set(String, Object, DateTimeOffset, String)

在衍生類別中遭覆寫時，在快取中插入快取項目，並指定以時間為基礎的到期詳細資訊。

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

abstract member Set : string * obj * DateTimeOffset * string -> unit

Public MustOverride 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。

備註

如果符合 key 的專案不存在於快取中， value 則會 key 用來插入為新的快取專案。如果索引鍵相符 item 的專案存在，則會使用 value 來更新或覆寫快取專案。

適用於

Set(String, Object, CacheItemPolicy, String)