Cache.Insert メソッド

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)

パラメーター

例外

例

次の例は、アプリケーションのオブジェクトに項目を挿入するときに、優先順位の高い項目を割り当てる方法を示して Cache います。The following example demonstrates how to assign an item high priority when you insert it into your application's Cache object.

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 します。This method will overwrite an existing Cache item with the same key parameter.

パラメーターとパラメーターの両方を設定することはできません absoluteExpiration slidingExpiration 。You cannot set both the absoluteExpiration and slidingExpiration parameters. キャッシュ項目が特定の時刻に期限切れになるようにする場合は、 absoluteExpiration パラメーターを特定の時刻に設定し、 slidingExpiration パラメーターをに設定し NoSlidingExpiration ます。If you intend the cache item to expire at a specific time, you set the absoluteExpiration parameter to the specific time, and the slidingExpiration parameter to NoSlidingExpiration.

項目に最後にアクセスしてから一定の時間が経過した後にキャッシュ項目の有効期限が切れるようにするには、 slidingExpiration パラメーターを有効期限の間隔に設定し、 absoluteExpiration パラメーターをに設定し NoAbsoluteExpiration ます。If you intend the cache item to expire after a certain amount of time has passed since the last access to the item, you set the slidingExpiration parameter to the expiration interval, and the absoluteExpiration parameter to NoAbsoluteExpiration.

こちらもご覧ください

• DateTime
• TimeSpan
• CacheItemPriority
• CacheItemRemovedCallback
• アプリケーションデータのキャッシュCaching Application Data

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)

パラメーター

例外

注釈

Insertメソッドを使用すると、キャッシュに新しい項目を挿入し、項目がキャッシュから削除される前に呼び出されるデリゲートを指定することができます。The Insert method enables you to insert a new item in the cache and provide a delegate that is called before the item is removed from the cache. デリゲートでは、キャッシュされた項目を更新して、キャッシュから削除されないようにすることができます。In the delegate, you can update the cached item and thereby prevent it from being removed from the cache.

このメソッドは Cache 、同じパラメーターを持つ既存の項目を上書き key します。This method will overwrite an existing Cache item with the same key parameter.

パラメーターとパラメーターの両方を設定することはできません absoluteExpiration slidingExpiration 。You cannot set both the absoluteExpiration and slidingExpiration parameters. キャッシュ項目が特定の時刻に期限切れになるようにする場合は、 absoluteExpiration パラメーターを特定の時刻に設定し、 slidingExpiration パラメーターをに設定し NoSlidingExpiration ます。If you intend the cache item to expire at a specific time, you set the absoluteExpiration parameter to the specific time, and the slidingExpiration parameter to NoSlidingExpiration.

項目が最後にアクセスされてからの設定期間が経過した後にキャッシュ項目の有効期限が切れるようにするには、 slidingExpiration パラメーターを有効期限の間隔に設定し、 absoluteExpiration パラメーターをに設定し NoAbsoluteExpiration ます。If you intend the cache item to expire after a set period of time since the item was last accessed, you set the slidingExpiration parameter to the expiration interval, and you set the absoluteExpiration parameter to NoAbsoluteExpiration.

こちらもご覧ください

• CacheItemUpdateCallback

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)

パラメーター

例外

例

次の例は、XML 構成ファイルにキャッシュ依存関係がある項目をアプリケーションのキャッシュに挿入する方法を示しています。The following example demonstrates how to insert an item into an application's cache with a cache dependency on an XML configuration file.

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

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

注釈

このメソッドは、パラメーターと一致するキーを持つ既存のキャッシュ項目を上書き key します。This method will overwrite an existing cache item whose key matches the key parameter. メソッドのこのオーバーロードを使用してキャッシュに追加されたオブジェクト Insert は、の優先度、 Default スライド式有効期限の値、 NoSlidingExpiration および絶対有効期限の値で挿入され NoAbsoluteExpiration ます。The object added to the cache using this overload of the Insert method is inserted with a priority of Default, a sliding expiration value of NoSlidingExpiration, and an absolute expiration value of NoAbsoluteExpiration.

こちらもご覧ください

• CacheDependency

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)

パラメーター

例外

例

次の例は、アプリケーションのキャッシュに項目を挿入する方法を示しています。The following example demonstrates how to insert an item into an application's cache.

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

注釈

このメソッドは、パラメーターと一致するキーを持つ既存のキャッシュ項目を上書き key します。This method will overwrite an existing cache item whose key matches the key parameter. メソッドのこのオーバーロードを使用して、キャッシュに追加されたオブジェクトは、 Insert ファイルまたはキャッシュの依存関係、優先度、 Default スライド式有効期限の値、 NoSlidingExpiration およびの絶対有効期限の値を指定せずに挿入され NoAbsoluteExpiration ます。The object added to the cache using this overload of the Insert method is inserted with no file or cache dependencies, a priority of Default, a sliding expiration value of NoSlidingExpiration, and an absolute expiration value of NoAbsoluteExpiration.

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)

パラメーター

例外

例

次の例は、絶対有効期限を使用して、アプリケーションのキャッシュに項目を挿入する方法を示しています。The following example demonstrates how to insert an item into an application's cache with an absolute expiration.

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

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

次の例は、スライド式有効期限を持つ項目をキャッシュに挿入する方法を示しています。The following example demonstrates how to insert an item into the cache with a sliding expiration.

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

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

注釈

このメソッドは Cache 、同じパラメーターを持つ既存の項目を上書き key します。This method will overwrite an existing Cache item with the same key parameter.

slidingExpirationパラメーターがに設定されている場合 NoSlidingExpiration 、スライド式有効期限は無効になります。If the slidingExpiration parameter is set to NoSlidingExpiration, sliding expiration is disabled. パラメーターをより大きい値に設定すると、パラメーターに slidingExpiration Zero は、パラメーターに格納されて absoluteExpiration いる値に加えてが設定され Now slidingExpiration ます。If you set the slidingExpiration parameter to greater than Zero, the absoluteExpiration parameter is set to Now plus the value contained in the slidingExpiration parameter. パラメーターで指定した時間が経過する前にキャッシュから項目が要求された場合、 absoluteExpiration 項目は再びキャッシュに配置され、 absoluteExpiration さらに、 DateTime.Now パラメーターに格納されている値に加算され slidingExpiration ます。If the item is requested from the cache before the amount of time specified by the absoluteExpiration parameter, the item will be placed in the cache again, and absoluteExpiration will again be set to DateTime.Now plus the value contained in the slidingExpiration parameter. 項目がキャッシュから要求されていない場合、パラメーターの日付の前に、 absoluteExpiration 項目がキャッシュから削除されます。If the item is not requested from the cache before the date in the absoluteExpiration parameter, the item is removed from the cache. Insert メソッドのこのオーバーロードを使用してキャッシュに追加された項目は、の優先度で挿入され Default ます。The item added to the cache using this overload of the insert method is inserted with a priority of Default.

こちらもご覧ください

• DateTime
• TimeSpan
• アプリケーションデータのキャッシュCaching Application Data