ObjectCache.AddOrGetExisting メソッド

定義

名前空間:

System.Runtime.Caching

アセンブリ:

System.Runtime.Caching.dll

パッケージ:

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

派生クラスでオーバーライドされると、キャッシュ エントリをキャッシュに挿入しようと試み、一致するキーを持つ既存のキャッシュ エントリを返します。

オーバーロード

AddOrGetExisting(CacheItem, CacheItemPolicy)	派生クラスでオーバーライドされると、指定された CacheItem オブジェクトをキャッシュに挿入し、エントリの削除方法に関する情報を指定します。
AddOrGetExisting(String, Object, DateTimeOffset, String)	派生クラスでオーバーライドされると、キー、キャッシュ エントリのオブジェクト、絶対有効期限の値、およびオプションでキャッシュを追加する領域を使用して、キャッシュ エントリをキャッシュに挿入します。
AddOrGetExisting(String, Object, CacheItemPolicy, String)	派生クラスでオーバーライドされると、キャッシュ エントリをキャッシュに挿入し、キャッシュ エントリのキーと値、およびエントリの削除方法の情報を指定します。

注釈

メソッドオーバーロードは AddOrGetExisting 、キャッシュにエントリを挿入します。 一致するキーを持つキャッシュ エントリが既に存在する場合は、既存のエントリが返されます。 キャッシュ エントリには、 CacheItem オブジェクトまたは汎用オブジェクトを指定できます。

オーバーロードとAddオーバーロードには AddOrGetExisting 1 つの違いがあります。 これらのオーバーロードされたメソッドがキャッシュ エントリを挿入しようとすると、既存の挿入されたキャッシュ エントリと一致するキーを持つ既存のエントリが見つかった場合、 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 返します。