CacheItemUpdateCallback 代理人

定義

キャッシュされた項目がキャッシュから削除される前にアプリケーションに通知するためのコールバック メソッドを定義します。

public delegate void CacheItemUpdateCallback(System::String ^ key, CacheItemUpdateReason reason, [Runtime::InteropServices::Out] System::Object ^ % expensiveObject, [Runtime::InteropServices::Out] CacheDependency ^ % dependency, [Runtime::InteropServices::Out] DateTime % absoluteExpiration, [Runtime::InteropServices::Out] TimeSpan % slidingExpiration);
public delegate void CacheItemUpdateCallback(string key, CacheItemUpdateReason reason, out object expensiveObject, out CacheDependency dependency, out DateTime absoluteExpiration, out TimeSpan slidingExpiration);
type CacheItemUpdateCallback = delegate of string * CacheItemUpdateReason * obj * CacheDependency * DateTime * TimeSpan -> unit
Public Delegate Sub CacheItemUpdateCallback(key As String, reason As CacheItemUpdateReason, ByRef expensiveObject As Object, ByRef dependency As CacheDependency, ByRef absoluteExpiration As DateTime, ByRef slidingExpiration As TimeSpan)

パラメーター

key
String

キャッシュから削除される項目の識別子。

reason
CacheItemUpdateReason

項目がキャッシュから削除される理由。

expensiveObject
Object

このメソッドから制御が戻るときに、更新プログラムを含むキャッシュされた項目オブジェクトが格納されます。

dependency
CacheDependency

このメソッドから制御が戻るときに、項目オブジェクトとファイル、キャッシュ キー、いずれかの配列、または別の CacheDependency オブジェクトの依存関係を定義するオブジェクトが格納されます。

absoluteExpiration
DateTime

このメソッドから制御が戻るときに、オブジェクトの有効期限が切れた時刻が格納されます。

slidingExpiration
TimeSpan

このメソッドから制御が戻るときに、オブジェクトが最後にアクセスされた時刻からオブジェクトの有効期限が切れた時刻までの間隔が格納されます。

注釈

キャッシュ内でオブジェクトの有効期限が切れると、ASP.NET は、キャッシュ 項目のキーとアイテムを更新する理由を指定して、CacheItemUpdateCallback メソッドを呼び出します。 このメソッドの残りのパラメーターは out パラメーターです。 新しいキャッシュされた項目と、キャッシュされた項目を更新するときに使用するオプションの有効期限と依存関係の値を指定します。

キャッシュされた項目が Removeの呼び出しを使用して明示的に削除された場合、更新コールバックは呼び出されません。

キャッシュされた項目をキャッシュから削除する場合は、expensiveObject パラメーターでnullを返す必要があります。 それ以外の場合は、 expensiveObject パラメーターを使用して、新しいキャッシュされたデータへの参照を返します。 有効期限または依存関係の値を指定しない場合、項目はメモリが必要な場合にのみキャッシュから削除されます。

コールバック メソッドが例外をスローした場合、ASP.NET は例外を抑制し、キャッシュされた値を削除します。

拡張メソッド

名前 説明
GetMethodInfo(Delegate)

指定したデリゲートによって表されるメソッドを表すオブジェクトを取得します。

適用対象