ObjectCache.Add メソッド

定義

名前空間:

System.Runtime.Caching

アセンブリ:

System.Runtime.Caching.dll

パッケージ:

System.Runtime.Caching v9.0.0

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

オーバーロード

Add(CacheItem, CacheItemPolicy)	派生クラスでオーバーライドされると、キャッシュ エントリを CacheItem インスタンスとしてキャッシュに挿入しようと試み、エントリの削除方法の詳細を追加します。
Add(String, Object, DateTimeOffset, String)	派生クラスでオーバーライドされると、既存のキャッシュ エントリを上書きせずに、キャッシュ エントリをキャッシュに挿入します。
Add(String, Object, CacheItemPolicy, String)	派生クラスでオーバーライドされると、キャッシュ エントリをキャッシュに挿入し、エントリの削除方法に関する情報を指定します。

注釈

メソッドのオーバーロードは Add 、同じキーを持つ既存のキャッシュ エントリを上書きまたは削除することなく、キャッシュにキャッシュ エントリを挿入しようとします。 キャッシュ エントリには、型指定された CacheItem オブジェクトまたはジェネリック オブジェクトを指定できます。

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