ObjectCache.Add 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
當在衍生類別中覆寫時，會插入快取條目，且不需回傳帶有匹配金鑰的現有快取條目。
多載
| 名稱 | Description |
|---|---|
| Add(CacheItem, CacheItemPolicy) |
當在衍生類別中被覆寫時，會嘗試將快取條目作為 CacheItem 實例插入快取，並新增該條目應如何被驅逐的細節。 |
| Add(String, Object, DateTimeOffset, String) |
在衍生類別中覆寫時，將快取專案插入快取中，而不覆寫任何現有的快取專案。 |
| Add(String, Object, CacheItemPolicy, String) |
在衍生類別中覆寫時，將快取專案插入快取中，並指定如何收回專案的相關信息。 |
備註
Add方法重載嘗試將快取條目插入快取，而不覆蓋或移除具有相同金鑰的現有快取條目。 快取項目可以是有 CacheItem 型別的物件，也可以是一般物件。
AddOrGetExisting方法過載與Add方法過載有一個顯著差異。 當這些方法插入快取條目時，若快取中找到匹配的條目， AddOrGetExisting 方法會回傳現有快取條目，但 Add 方法過載則不會。 擁有這些不同的方法重載，讓呼叫者能根據是否需要現有快取條目來優化程式碼。 在分散式快取中，使用 AddOrGetExisting 該方法回傳現有值可能比用方法回傳布林值 Add 更昂貴。
Add(CacheItem, CacheItemPolicy)
當在衍生類別中被覆寫時，會嘗試將快取條目作為 CacheItem 實例插入快取，並新增該條目應如何被驅逐的細節。
public:
virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);public virtual bool Add(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> boolPublic Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean參數
- item
- CacheItem
要補充的目標。
- policy
- CacheItemPolicy
一個包含快取項目驅逐細節的物件。 這個物件提供了比單純絕對淘汰更多的淘汰選項。
傳回
true 插入成功，或 false 快取中已有與 相同的金鑰 item條目。
備註
Add方法的過載在類別上是虛擬的（而非抽象的），ObjectCache因為Add該方法內部會呼叫 AddOrGetExisting。 這減少了快取實作者必須提供的方法過載次數。 如果快取實作不需要對方法有特殊行為 Add ，它只需實作 AddOrGetExisting 方法的超載即可。
適用於
Add(String, Object, DateTimeOffset, String)
在衍生類別中覆寫時，將快取專案插入快取中，而不覆寫任何現有的快取專案。
public virtual bool Add(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> boolPublic Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Boolean參數
- key
- String
快取項目的唯一識別碼。
- value
- Object
要插入的物件。
- absoluteExpiration
- DateTimeOffset
快取條目到期的固定日期與時間。 當呼叫該 Add 方法時，必須包含此參數。
- regionName
- String
Optional. 快取中可新增快取條目（若實作區域）的指定區域。 由於 Framework 4 .NET未實作區域，預設值為 null。
傳回
true 插入成功，或 false 快取中已有與 相同的金鑰 key條目。
備註
Add方法的過載在類別上是虛擬的（而非抽象的），ObjectCache因為Add該方法內部會呼叫 AddOrGetExisting。 這減少了快取實作者必須提供的方法過載次數。 如果快取實作不需要對方法有特殊行為 Add ，它只需實作 AddOrGetExisting 方法的超載即可。
適用於
Add(String, Object, CacheItemPolicy, String)
在衍生類別中覆寫時，將快取專案插入快取中，並指定如何收回專案的相關信息。
public virtual bool Add(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> boolPublic Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Boolean參數
- key
- String
快取項目的唯一識別碼。
- value
- Object
要插入的物件。
- policy
- CacheItemPolicy
一個包含快取項目驅逐細節的物件。 這個物件提供了比單純絕對淘汰更多的淘汰選項。
- regionName
- String
Optional. 快取中可新增快取條目（若實作區域）的指定區域。 可選參數的預設值為 null。
傳回
true 如果插入嘗試成功，或 false 快取中已有與 相同的金鑰 key的條目。
備註
Add方法的過載在類別上是虛擬的（而非抽象的），ObjectCache因為Add該方法內部會呼叫 AddOrGetExisting。 這減少了快取實作者必須提供的方法過載次數。 如果快取實作不需要對方法有特殊行為 Add ，它只需實作 AddOrGetExisting 方法的超載即可。