ObjectCache.AddOrGetExisting 方法

定義

命名空間:

System.Runtime.Caching

組件:

System.Runtime.Caching.dll

套件:

System.Runtime.Caching v9.0.0

在衍生類別中遭覆寫時，嘗試在快取區中插入快取項目，並傳回包含相符索引鍵的現有快取項目。

多載

AddOrGetExisting(CacheItem, CacheItemPolicy)	在衍生類別中遭覆寫時，將指定的 CacheItem 物件插入至快取中，並指定關於要如何收回項目的資訊。
AddOrGetExisting(String, Object, DateTimeOffset, String)	在衍生類別中遭覆寫時，利用索引鍵、快取項目物件、絕對逾期值以及要將快取加入至的選擇性區域，將快取項目插快取取區中。
AddOrGetExisting(String, Object, CacheItemPolicy, String)	在衍生類別中遭覆寫時，在快取中插入快取項目，並指定快取項目的索引鍵和值，以及關於要如何收回項目的資訊。

備註

方法會 AddOrGetExisting 多載將專案插入快取中。 如果具有相符索引鍵的快取專案已經存在，則會傳回現有的專案。 快取專案可以是 CacheItem 物件或泛型物件。

多 AddOrGetExisting 載與 Add 多載之間有一個差異。 當這些多載方法嘗試插入快取專案時，如果找到具有符合現有插入快取專案之索引鍵的現有專案，多 AddOrGetExisting 載會傳回現有的快取專案。 多 Add 載不會。

AddOrGetExisting(CacheItem, CacheItemPolicy)

來源:

ObjectCache.cs

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

public:
 abstract System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ value, System::Runtime::Caching::CacheItemPolicy ^ policy);

public abstract System.Runtime.Caching.CacheItem AddOrGetExisting (System.Runtime.Caching.CacheItem value, System.Runtime.Caching.CacheItemPolicy policy);

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

Public MustOverride Function AddOrGetExisting (value As CacheItem, policy As CacheItemPolicy) As CacheItem

參數

value

CacheItem

要插入的物件。

policy

CacheItemPolicy

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

傳回

CacheItem

如果存在索引鍵相同的快取項目，則為指定的快取項目，否則為 null。

AddOrGetExisting(String, Object, DateTimeOffset, String)

來源:

ObjectCache.cs

在衍生類別中遭覆寫時，利用索引鍵、快取項目物件、絕對逾期值以及要將快取加入至的選擇性區域，將快取項目插快取取區中。

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

abstract member AddOrGetExisting : string * obj * DateTimeOffset * string -> obj

Public MustOverride Function AddOrGetExisting (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Object

參數

key

String

快取項目的唯一識別項。

value

Object

要插入的物件。

absoluteExpiration

DateTimeOffset

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

regionName

String

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

傳回

Object

如果存在具有相同索引鍵的快取項目，則為指定之快取項目的值，否則為 null。

備註

這個 AddOrGetExisting(String, Object, DateTimeOffset, String) 方法多載會傳回物件值，而不是 CacheItem 物件。

AddOrGetExisting(String, Object, CacheItemPolicy, String)

來源:

ObjectCache.cs

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

public abstract object AddOrGetExisting (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

abstract member AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> obj

Public MustOverride Function AddOrGetExisting (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Object

參數

key

String

快取項目的唯一識別項。

value

Object

要插入的物件。

policy

CacheItemPolicy

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

regionName

String

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

傳回

Object

如果存在具有相同索引鍵的快取項目，則為指定之快取項目的值，否則為 null。

備註

方法 AddOrGetExisting(String, Object, CacheItemPolicy, String) 會傳回物件值，而不是 CacheItem 物件。