ObjectCache.Add 方法

定義

命名空間:

System.Runtime.Caching

組件:

System.Runtime.Caching.dll

套件:

System.Runtime.Caching v9.0.0-rc.2.24473.5

在衍生類別中遭覆寫時，在快取中插入快取項目，而不要求傳回具有相符索引鍵的現有快取項目。

多載

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)

來源:

ObjectCache.cs

在衍生類別中遭覆寫時，嘗試在快取區中插入做為 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 -> bool

Public Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean

參數

item

CacheItem

要加入的物件。

policy

CacheItemPolicy

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

傳回

Boolean

如果插入成功則為 true，如果快取中已經有項目具有與 item 相同的索引鍵，則為 false。

備註

方法 Add 多載是虛擬 (不是類別上的 ObjectCache 抽象) ，因為 Add 方法會在內部呼叫 AddOrGetExisting。 這會減少快取實作器必須提供的方法多載數目。 如果快取實作不需要方法的任何特殊行為 Add ，就只能實 AddOrGetExisting 作方法多載。

Add(String, Object, DateTimeOffset, String)

來源:

ObjectCache.cs

在衍生類別中覆寫時，在快取中插入快取項目，但不覆寫任何現有的快取項目。

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 -> bool

Public 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

選擇性。 如果已實作區域，則為快取區中的具名區域，快取項目可以加入至這個區域。 因為區域未在 .NET Framework 4 中實作，所以預設值為 null。

傳回

Boolean

如果插入成功則為 true，如果快取中已經有項目具有與 key 相同的索引鍵，則為 false。

備註

方法 Add 多載是虛擬 (不是類別上的 ObjectCache 抽象) ，因為 Add 方法會在內部呼叫 AddOrGetExisting。 這會減少快取實作器必須提供的方法多載數目。 如果快取實作不需要方法的任何特殊行為 Add ，就只能實 AddOrGetExisting 作方法多載。

Add(String, Object, CacheItemPolicy, String)

來源:

ObjectCache.cs

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

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 -> bool

Public 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

選擇性。 如果已實作區域，則為快取區中的具名區域，快取項目可以加入至這個區域。 選擇性參數的預設值為 null。

傳回

Boolean

在成功插入項目的情況下為 true，如果快取區中已經包含項目，而且該項目的索引鍵與 key 相同，則為 false。

備註

方法 Add 多載是虛擬 (不是類別上的 ObjectCache 抽象) ，因為 Add 方法會在內部呼叫 AddOrGetExisting。 這會減少快取實作器必須提供的方法多載數目。 如果快取實作不需要方法的任何特殊行為 Add ，就只能實 AddOrGetExisting 作方法多載。