Cache.Insert メソッド

定義

項目を Cache オブジェクトに挿入します。 このメソッドのいずれかのバージョンを使用して、同じ key パラメーターで既存の Cache 項目を上書きします。

オーバーロード

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

依存関係ポリシー、有効期限ポリシー、優先順位ポリシー、および挿入された項目が Cache から削除されたことをアプリケーションに通知するために使用できるデリゲートを指定して、Cache オブジェクトにオブジェクトを挿入します。

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)

依存関係、有効期限ポリシー、およびキャッシュから項目が削除される前のアプリケーションへの通知に使用できるデリゲートを指定して、Cache オブジェクトにオブジェクトを挿入します。

Insert(String, Object, CacheDependency)

ファイル依存関係またはキー依存関係を持つオブジェクトを Cache に挿入します。

Insert(String, Object)

項目の位置を参照するキャッシュ キーを指定し、CacheItemPriority 列挙体が提供する既定値を使用して、Cache オブジェクトに項目を挿入します。

Insert(String, Object, CacheDependency, DateTime, TimeSpan)

依存関係ポリシーと有効期限ポリシーを指定して、Cache にオブジェクトを挿入します。

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

依存関係ポリシー、有効期限ポリシー、優先順位ポリシー、および挿入された項目が Cache から削除されたことをアプリケーションに通知するために使用できるデリゲートを指定して、Cache オブジェクトにオブジェクトを挿入します。

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemPriority priority, System::Web::Caching::CacheItemRemovedCallback ^ onRemoveCallback);
public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemPriority priority, System.Web.Caching.CacheItemRemovedCallback onRemoveCallback);
member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> unit
Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback)

パラメーター

key
String

オブジェクトの参照に使用されるキャッシュ キー。

value
Object

キャッシュに挿入するオブジェクト。

dependencies
CacheDependency

項目のファイル依存関係またはキャッシュ キー依存関係。 依存関係が変化すると、オブジェクトは無効になり、キャッシュから削除されます。 依存関係がない場合は、このパラメーターには null が格納されます。

absoluteExpiration
DateTime

挿入されたオブジェクトが期限切れとなり、キャッシュから削除される時刻。 標準時間から夏時間への変更など、ローカル時間に関する問題を回避するには、このパラメーター値には Now ではなく UtcNow を使用してください。 絶対有効期限を使用している場合は、slidingExpiration パラメーターは NoSlidingExpiration にする必要があります。

slidingExpiration
TimeSpan

挿入されたオブジェクトが最後にアクセスされてからそのオブジェクトが期限切れになるまでの間隔。 この値が 20 分に相当する場合、オブジェクトは、最後のアクセスから 20 分経過すると有効期限が切れ、キャッシュから削除されます。 スライド式有効期限を使用している場合は、absoluteExpiration パラメーターは NoAbsoluteExpiration にする必要があります。

priority
CacheItemPriority

CacheItemPriority 列挙体によって表現される、キャッシュ内に格納された他の項目に対するオブジェクトの相対コスト。 キャッシュからオブジェクトが削除されるときにこの値が使用されます。コストが低いオブジェクトは、コストが高いオブジェクトよりも先にキャッシュから削除されます。

onRemoveCallback
CacheItemRemovedCallback

オブジェクトがキャッシュから削除されると呼び出されるデリゲート (指定されている場合)。 このデリゲートを使用して、オブジェクトがキャッシュから削除されたことをアプリケーションに通知できます。

例外

key パラメーターまたは value パラメーターが null です。

slidingExpiration パラメーターは、TimeSpan.Zero 未満、または 1 年を超える年数に設定します。

Cache に追加しようとした項目に、absoluteExpiration パラメーターと slidingExpiration パラメーターの両方が設定されます。

次の例では、アプリケーション Cache の オブジェクトに項目を挿入するときに、項目の優先度を高く割り当てる方法を示します。

注意

デリゲートで CacheItemRemovedCallback このメソッドを使用する方法の詳細については、「 方法: キャッシュから項目が削除されたときにアプリケーションに通知する」を参照してください。

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove);

Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove)

注釈

このメソッドは、既存 Cache の項目を同じ key パラメーターで上書きします。

パラメーターと slidingExpiration パラメーターの両方をabsoluteExpiration設定することはできません。 キャッシュ 項目を特定の時刻に期限切れにする場合は、 パラメーターを absoluteExpiration 特定の時刻に設定し、 パラメーターを slidingExpirationNoSlidingExpiration設定します。

アイテムへの最後のアクセスから一定の時間が経過した後にキャッシュ アイテムの有効期限が切れる場合は、 パラメーターを slidingExpiration 有効期限に設定し、 パラメーターを absoluteExpirationNoAbsoluteExpiration設定します。

こちらもご覧ください

適用対象

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)

依存関係、有効期限ポリシー、およびキャッシュから項目が削除される前のアプリケーションへの通知に使用できるデリゲートを指定して、Cache オブジェクトにオブジェクトを挿入します。

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemUpdateCallback ^ onUpdateCallback);
public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemUpdateCallback onUpdateCallback);
member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemUpdateCallback -> unit
Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, onUpdateCallback As CacheItemUpdateCallback)

パラメーター

key
String

オブジェクトの参照に使用されるキャッシュ キー。

value
Object

キャッシュに挿入するオブジェクト。

dependencies
CacheDependency

項目のファイル依存関係またはキャッシュ キー依存関係。 依存関係が変化すると、オブジェクトは無効になり、キャッシュから削除されます。 依存関係がない場合は、このパラメーターには null が格納されます。

absoluteExpiration
DateTime

挿入されたオブジェクトが期限切れとなり、キャッシュから削除される時刻。 標準時間から夏時間への変更など、ローカル時間に関する問題を回避するには、このパラメーター値には Now ではなく UtcNow を使用してください。 絶対有効期限を使用している場合は、slidingExpiration パラメーターは NoSlidingExpiration に設定する必要があります。

slidingExpiration
TimeSpan

キャッシュされたオブジェクトが最後にアクセスされてからそのオブジェクトが期限切れになるまでの間隔。 この値が 20 分に相当する場合、オブジェクトは、最後のアクセスから 20 分経過すると有効期限が切れ、キャッシュから削除されます。 スライド式有効期限を使用している場合は、absoluteExpiration パラメーターは NoAbsoluteExpiration に設定する必要があります。

onUpdateCallback
CacheItemUpdateCallback

オブジェクトがキャッシュから削除される前に呼び出されるデリゲート。 これを使用して、キャッシュされた項目を更新し、キャッシュから削除されないようにできます。

例外

keyvalue、または onUpdateCallback パラメーターが nullです。

slidingExpiration パラメーターは、TimeSpan.Zero 未満、または 1 年を超える年数に設定します。

Cache に追加しようとした項目に、absoluteExpiration パラメーターと slidingExpiration パラメーターの両方が設定されます。

- または -

dependencies パラメーターは null であり、absoluteExpiration パラメーターは NoAbsoluteExpiration に設定され、slidingExpiration パラメーターは NoSlidingExpiration に設定されます。

注釈

Insertメソッドを使用すると、キャッシュに新しい項目を挿入し、キャッシュから項目が削除される前に呼び出されるデリゲートを提供できます。 デリゲートでは、キャッシュされたアイテムを更新して、キャッシュから削除されないようにすることができます。

このメソッドは、既存 Cache の項目を同じ key パラメーターで上書きします。

パラメーターと slidingExpiration パラメーターの両方をabsoluteExpiration設定することはできません。 キャッシュ 項目を特定の時刻に期限切れにする場合は、 パラメーターを absoluteExpiration 特定の時刻に設定し、 パラメーターを slidingExpirationNoSlidingExpiration設定します。

アイテムが最後にアクセスされてから一定の期間が経過した後にキャッシュ アイテムの有効期限が切れる場合は、 パラメーターを slidingExpiration 有効期限に設定し、 パラメーターを absoluteExpirationNoAbsoluteExpiration設定します。

こちらもご覧ください

適用対象

Insert(String, Object, CacheDependency)

ファイル依存関係またはキー依存関係を持つオブジェクトを Cache に挿入します。

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies);
public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies);
member this.Insert : string * obj * System.Web.Caching.CacheDependency -> unit
Public Sub Insert (key As String, value As Object, dependencies As CacheDependency)

パラメーター

key
String

項目の識別に使用されるキャッシュ キー。

value
Object

キャッシュに挿入するオブジェクト。

dependencies
CacheDependency

挿入されるオブジェクトのファイル依存関係またはキャッシュ キー依存関係。 依存関係が変化すると、オブジェクトは無効になり、キャッシュから削除されます。 依存関係がない場合は、このパラメーターには null が格納されます。

例外

key パラメーターまたは value パラメーターが null です。

次の例では、XML 構成ファイルに対するキャッシュ依存関係を使用して、アプリケーションのキャッシュに項目を挿入する方法を示します。

Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));

Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))

注釈

このメソッドは、キーが パラメーターと一致する既存のキャッシュ 項目を key 上書きします。 メソッドのこのオーバーロード Insert を使用してキャッシュに追加されたオブジェクトは、 の Default優先度、スライディング有効期限値、 NoSlidingExpirationの絶対有効期限値 NoAbsoluteExpirationを使用して挿入されます。

こちらもご覧ください

適用対象

Insert(String, Object)

項目の位置を参照するキャッシュ キーを指定し、CacheItemPriority 列挙体が提供する既定値を使用して、Cache オブジェクトに項目を挿入します。

public:
 void Insert(System::String ^ key, System::Object ^ value);
public void Insert (string key, object value);
member this.Insert : string * obj -> unit
Public Sub Insert (key As String, value As Object)

パラメーター

key
String

項目の参照に使用されるキャッシュ キー。

value
Object

キャッシュに挿入するオブジェクト。

例外

key パラメーターまたは value パラメーターが null です。

次の例では、アプリケーションのキャッシュに項目を挿入する方法を示します。

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

注釈

このメソッドは、キーが パラメーターと一致する既存のキャッシュ 項目を key 上書きします。 メソッドのこのオーバーロードを使用してキャッシュに追加されたオブジェクトは、ファイルまたはキャッシュの Insert 依存関係がなく、優先度が の Default、スライディング有効期限値が NoSlidingExpiration、 の絶対有効期限値 NoAbsoluteExpirationが挿入されます。

こちらもご覧ください

適用対象

Insert(String, Object, CacheDependency, DateTime, TimeSpan)

依存関係ポリシーと有効期限ポリシーを指定して、Cache にオブジェクトを挿入します。

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);
public void Insert (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);
member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan -> unit
Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan)

パラメーター

key
String

オブジェクトの参照に使用されるキャッシュ キー。

value
Object

キャッシュに挿入するオブジェクト。

dependencies
CacheDependency

挿入されるオブジェクトのファイル依存関係またはキャッシュ キー依存関係。 依存関係が変化すると、オブジェクトは無効になり、キャッシュから削除されます。 依存関係がない場合は、このパラメーターには null が格納されます。

absoluteExpiration
DateTime

挿入されたオブジェクトが期限切れとなり、キャッシュから削除される時刻。 標準時間から夏時間への変更など、ローカル時間に関する問題を回避するには、このパラメーター値には Now ではなく UtcNow を使用してください。 絶対有効期限を使用している場合は、slidingExpiration パラメーターは NoSlidingExpiration にする必要があります。

slidingExpiration
TimeSpan

挿入されたオブジェクトが最後にアクセスされた日時とそのオブジェクトの有効期限が切れる時刻の間隔です。 この値が 20 分に相当する場合、オブジェクトは、最後のアクセスから 20 分経過すると有効期限が切れ、キャッシュから削除されます。 スライド式有効期限を使用している場合は、absoluteExpiration パラメーターは NoAbsoluteExpiration にする必要があります。

例外

key パラメーターまたは value パラメーターが null です。

slidingExpiration パラメーターは、TimeSpan.Zero 未満、または 1 年を超える年数に設定します。

Cache に追加しようとした項目に、absoluteExpiration パラメーターと slidingExpiration パラメーターの両方が設定されます。

次の例では、絶対有効期限でアプリケーションのキャッシュに項目を挿入する方法を示します。

注意

この形式の メソッドではキャッシュの依存関係がInsertサポートされているため、項目に依存関係がない場合は、パラメーターのdependencyコンマ区切りリストで パラメーターを (Nothing Visual Basic の場合) としてnull宣言する必要があります。

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);
Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)

次の例では、スライディング有効期限を使用してキャッシュに項目を挿入する方法を示します。

Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));
Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))

注釈

このメソッドは、同じkeyパラメーターを持つ既存Cacheの項目を上書きします。

パラメーターが slidingExpirationNoSlidingExpiration設定されている場合、スライディング有効期限は無効になります。 パラメーターを slidingExpiration よりZero大きい に設定した場合、absoluteExpirationパラメーターは に、パラメーターに含まれる値を加算してNowslidingExpiration設定されます。 パラメーターでabsoluteExpiration指定された時間の前にアイテムがキャッシュから要求された場合、項目は再びキャッシュに配置されabsoluteExpiration、パラメーターに含まれるslidingExpiration値を加算するようにDateTime.Now再び設定されます。 項目が パラメーターの日付 absoluteExpiration より前にキャッシュから要求されていない場合、項目はキャッシュから削除されます。 insert メソッドのこのオーバーロードを使用してキャッシュに追加された項目は、 の Default優先順位で挿入されます。

こちらもご覧ください

適用対象