ObjectCache.Add メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
派生クラスでオーバーライドされると、一致するキーを持つ既存のキャッシュ エントリを返すことを要求せずに、キャッシュ エントリをキャッシュに挿入します。
オーバーロード
| 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
- ソース:
- 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 -> boolPublic Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Booleanパラメーター
- item
- CacheItem
追加するオブジェクト。
- policy
- CacheItemPolicy
キャッシュ エントリの削除の詳細を格納しているオブジェクト。 このオブジェクトは、単純な絶対有効期限よりも多くの削除オプションを提供します。
戻り値
挿入が成功した場合は true。item と同じキーを持つエントリがキャッシュに既に存在する場合は false。
注釈
メソッドのオーバーロードは Add 、 クラスの ObjectCache 仮想 (抽象ではない) です。これは、 メソッドが内部的に を Add 呼び出 AddOrGetExistingすからです。 これにより、キャッシュ実装者が提供する必要があるメソッド オーバーロードの数が減ります。 キャッシュ実装で メソッドに特別な動作 Add が必要ない場合は、メソッド のオーバーロードを AddOrGetExisting 実装できます。
適用対象
Add(String, Object, DateTimeOffset, String)
- ソース:
- ObjectCache.cs
- ソース:
- 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 -> 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
省略可能。 領域が実装されている場合は、キャッシュ エントリを追加できるキャッシュ内の名前付き領域。 .NET Framework 4 ではリージョンが実装されていないため、既定値は ですnull。
戻り値
挿入が成功した場合は true。key と同じキーを持つエントリがキャッシュに既に存在する場合は false。
注釈
メソッドのオーバーロードは Add 、 クラスの ObjectCache 仮想 (抽象ではない) です。これは、 メソッドが内部的に を Add 呼び出 AddOrGetExistingすからです。 これにより、キャッシュ実装者が提供する必要があるメソッド オーバーロードの数が減ります。 キャッシュ実装で メソッドに特別な動作 Add が必要ない場合は、メソッド のオーバーロードを AddOrGetExisting 実装できます。
適用対象
Add(String, Object, CacheItemPolicy, String)
- ソース:
- ObjectCache.cs
- ソース:
- 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 -> 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
省略可能。 領域が実装されている場合は、キャッシュ エントリを追加できるキャッシュ内の名前付き領域。 省略可能なパラメーターの既定値は null です。
戻り値
挿入の試行が成功した場合は true。key と同じキーを持つエントリがキャッシュに既に存在する場合は false。
注釈
メソッドのオーバーロードは Add 、 クラスの ObjectCache 仮想 (抽象ではない) です。これは、 メソッドが内部的に を Add 呼び出 AddOrGetExistingすからです。 これにより、キャッシュ実装者が提供する必要があるメソッド オーバーロードの数が減ります。 キャッシュ実装で メソッドに特別な動作 Add が必要ない場合は、メソッド のオーバーロードを AddOrGetExisting 実装できます。
適用対象
.NET