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 オブジェクトに項目を挿入するときに、項目の優先度を高く割り当てる方法を示します。

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項目を上書きします。

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

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

こちらもご覧ください

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

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 メソッドを使用すると、キャッシュに新しい項目を挿入し、その項目がキャッシュから削除される前に呼び出されるデリゲートを提供できます。 デリゲートでは、キャッシュされた項目を更新して、キャッシュから削除されないようにすることができます。

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

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

アイテムが最後にアクセスされてから一定の期間が経過した後にキャッシュ 項目の有効期限が切れる場合は、 slidingExpiration パラメーターを有効期限に設定し、 absoluteExpiration パラメーターを 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 構成ファイルに対するキャッシュ依存関係を持つアプリケーションのキャッシュに項目を挿入する方法を示します。

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 で挿入されます。

こちらもご覧ください

• 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)

パラメーター

例外

例

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

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

注釈

このメソッドは、キーが key パラメーターと一致する既存のキャッシュ 項目を上書きします。 Insert メソッドのこのオーバーロードを使用してキャッシュに追加されたオブジェクトは、ファイルまたはキャッシュの依存関係、Defaultの優先順位、NoSlidingExpirationのスライディング有効期限値、および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)

パラメーター

例外

例

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

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))

注釈

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

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

こちらもご覧ください

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