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 パラメーターで上書きします。

パラメーターと slidingExpiration パラメーターの両方をabsoluteExpiration設定することはできません。 キャッシュ 項目を特定の時刻に期限切れにする場合は、 パラメーターを 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 パラメーターで上書きします。

パラメーターと slidingExpiration パラメーターの両方をabsoluteExpiration設定することはできません。 キャッシュ 項目を特定の時刻に期限切れにする場合は、 パラメーターを 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))

注釈

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

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

こちらもご覧ください

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