Cache.Insert メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
項目を Cache オブジェクトに挿入します。 このメソッドのいずれかのバージョンを使用して、同じ key パラメーターで既存の Cache 項目を上書きします。
オーバーロード
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) |
依存関係ポリシー、有効期限ポリシー、優先順位ポリシー、および挿入された項目が |
| 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 -> unitPublic 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 の オブジェクトに項目を挿入するときに、項目の優先度を高く割り当てる方法を示します。
Note
デリゲートで 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 特定の時刻に設定し、 パラメーターを slidingExpiration に NoSlidingExpiration設定します。
アイテムへの最後のアクセスから一定の時間が経過した後にキャッシュ アイテムの有効期限が切れる場合は、 パラメーターを slidingExpiration 有効期限に設定し、 パラメーターを absoluteExpiration に NoAbsoluteExpiration設定します。
こちらもご覧ください
適用対象
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 -> unitPublic 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
オブジェクトがキャッシュから削除される前に呼び出されるデリゲート。 これを使用して、キャッシュされた項目を更新し、キャッシュから削除されないようにできます。
例外
key、value、または onUpdateCallback パラメーターが nullです。
slidingExpiration パラメーターは、TimeSpan.Zero 未満、または 1 年を超える年数に設定します。
Cache に追加しようとした項目に、absoluteExpiration パラメーターと slidingExpiration パラメーターの両方が設定されます。
- または -
dependencies パラメーターは null であり、absoluteExpiration パラメーターは NoAbsoluteExpiration に設定され、slidingExpiration パラメーターは NoSlidingExpiration に設定されます。
注釈
Insertメソッドを使用すると、キャッシュに新しい項目を挿入し、キャッシュから項目が削除される前に呼び出されるデリゲートを提供できます。 デリゲートでは、キャッシュされたアイテムを更新して、キャッシュから削除されないようにすることができます。
このメソッドは、既存 Cache の項目を同じ key パラメーターで上書きします。
パラメーターと slidingExpiration パラメーターの両方をabsoluteExpiration設定することはできません。 キャッシュ 項目を特定の時刻に期限切れにする場合は、 パラメーターを absoluteExpiration 特定の時刻に設定し、 パラメーターを slidingExpiration に NoSlidingExpiration設定します。
アイテムが最後にアクセスされてから一定の期間が経過した後にキャッシュ アイテムの有効期限が切れる場合は、 パラメーターを slidingExpiration 有効期限に設定し、 パラメーターを absoluteExpiration に NoAbsoluteExpiration設定します。
こちらもご覧ください
適用対象
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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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 パラメーターの両方が設定されます。
例
次の例では、絶対有効期限でアプリケーションのキャッシュに項目を挿入する方法を示します。
Note
この形式の メソッドではキャッシュの依存関係が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))
注釈
このメソッドは、既存 Cache の項目を同じ key パラメーターで上書きします。
パラメーターが slidingExpiration に NoSlidingExpiration設定されている場合、スライディング有効期限は無効になります。 パラメーターを slidingExpiration よりZero大きい に設定した場合、absoluteExpirationパラメーターは にパラメーターに含まれる値を加えたものにNowslidingExpiration設定されます。 パラメーターでabsoluteExpiration指定された時間より前にキャッシュからアイテムが要求された場合、項目は再びキャッシュに配置されabsoluteExpiration、パラメーターに含まれるslidingExpiration値を加算するようにDateTime.Now再び設定されます。 パラメーターの日付より前のキャッシュ absoluteExpiration からアイテムが要求されていない場合、項目はキャッシュから削除されます。 insert メソッドのこのオーバーロードを使用してキャッシュに追加された項目は、 の Default優先順位で挿入されます。
こちらもご覧ください
適用対象
.NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示