次の方法で共有

Cache.Insert メソッド (String, Object, CacheDependency, DateTime, TimeSpan)

依存関係ポリシーおよび有効期限ポリシーが設定されている Cache にオブジェクトを挿入します。

Overloads Public Sub Insert( _
   ByVal key As String, _   ByVal value As Object, _   ByVal dependencies As CacheDependency, _   ByVal absoluteExpiration As DateTime, _   ByVal slidingExpiration As TimeSpan _)
[C#]
public void Insert(stringkey,objectvalue,CacheDependencydependencies,DateTimeabsoluteExpiration,TimeSpanslidingExpiration);
[C++]
public: void Insert(String* key,Object* value,CacheDependency* dependencies,DateTimeabsoluteExpiration,TimeSpanslidingExpiration);
[JScript]
public function Insert(
   key : String,value : Object,dependencies : CacheDependency,absoluteExpiration : DateTime,slidingExpiration : TimeSpan);

パラメータ

  • key
    オブジェクトの参照に使用されるキャッシュ キー。
  • value
    キャッシュに挿入されるオブジェクト。
  • dependencies
    挿入されるオブジェクトのファイル依存関係またはキャッシュ キー依存関係。依存関係が変化すると、オブジェクトは無効になり、キャッシュから削除されます。依存関係がない場合は、このパラメータに null 参照 (Visual Basic では Nothing) が格納されます。
  • absoluteExpiration
    挿入されたオブジェクトの有効期限が切れて、オブジェクトがキャッシュから削除される時刻。
  • slidingExpiration
    挿入されたオブジェクトに最後にアクセスしてからその有効期限が切れるまでの間隔。この値が 20 分に設定されている場合は、オブジェクトに最後にアクセスしてから 20 分が経過すると、有効期限が切れて、オブジェクトがキャッシュから削除されます。

解説

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

slidingExpiration パラメータが NoSlidingExpiration に設定されている場合は、変化する有効期限が無効になります。 slidingExpiration パラメータを Zero を超える値に設定する場合、 absoluteExpiration パラメータは Now と slidingExpiration パラメータに保持された値を加えた値に設定されます。 absoluteExpiration パラメータで指定した合計時間に達する前に項目がキャッシュから要求されると、項目はキャッシュに再度配置され、 absoluteExpiration は、 DateTime.Now と slidingExpiration パラメータに保持されている値を加えた値に再設定されます。 absoluteExpiration パラメータで指定された日付より前に、項目がキャッシュから要求されないと、項目はキャッシュから削除されます。

メモ    key パラメータまたは value パラメータが null の場合は、 ArgumentNullException がスローされます。 slidingexpiration パラメータを TimeSpan.Zero 未満、または 1 年を超える年数に設定すると、 ArgumentOutOfRangeException がスローされます。キャッシュされた 1 つの項目に、変化する有効期限と絶対有効期限の両方は設定できません。設定すると、 ArgumentException がスローされます。

使用例

[Visual Basic, C#, C++] 絶対有効期限が設定されているアプリケーションのキャッシュに項目を挿入する方法を次の例で示します。

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

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

[C#] 
Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), TimeSpan.Zero);

[C++] 
Cache->Insert(S"DSN", connectionString, 0, DateTime::Now.AddMinutes(2), TimeSpan::Zero);

[Visual Basic, C#, C++] 変化する有効期限が設定されているキャッシュに項目を挿入する方法を次の例で示します。

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

[C#] 
Cache.Insert("DSN", connectionString, null, DateTime.MaxValue, TimeSpan.FromSeconds(10));

[C++] 
Cache->Insert(S"DSN", connectionString, 0, DateTime::MaxValue, TimeSpan::FromSeconds(10));

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

参照

Cache クラス | Cache メンバ | System.Web.Caching 名前空間 | Cache.Insert オーバーロードの一覧 | アプリケーション データのキャッシュ | DateTime | TimeSpan