ObjectCache.Set 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
當在衍生類別中被覆寫時，會插入快取項目。
多載
| 名稱 | Description |
|---|---|
| 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 -> unitPublic 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 -> unitPublic 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
Optional. 快取中可新增快取條目（若實作區域）的指定區域。 可選參數的預設值為 null。
備註
如果快取中不存在匹配 key 的項目， value 並 key 被用來插入作為新的快取項目。 若存在與鍵數相符 item 的項目，則會透過 更新 value或覆寫快取條目。
適用於
Set(String, Object, CacheItemPolicy, String)
當在衍生類別中被覆寫時，會插入快取項目。
public abstract void Set(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);abstract member Set : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> unitPublic MustOverride Sub Set (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing)參數
- key
- String
快取項目的唯一識別碼。
- value
- Object
要插入的物件。
- policy
- CacheItemPolicy
一個包含快取項目驅逐細節的物件。 這個物件提供了比單純絕對淘汰更多的淘汰選項。
- regionName
- String
Optional. 快取中可新增快取條目（若實作區域）的指定區域。 可選參數的預設值為 null。
備註
這種方法過載讓你能提供比時間基礎絕對到期更多的驅逐或到期細節。
如果快取中不存在匹配 key 的項目， value 並 key 被用來插入作為新的快取項目。 若存在與鍵數相符 item 的項目，則會透過 更新 value或覆寫快取條目。
