DataCache.Put メソッド (String, Object, DataCacheItemVersion, String)

オブジェクトが指定したバージョンである場合、指定したリージョン内でオブジェクトの追加または置換を行います。

名前空間: Microsoft.ApplicationServer.Caching
アセンブリ: Microsoft.ApplicationServer.Caching.Client (microsoft.applicationserver.caching.client.dll)

使用法

構文

'宣言
Public Function Put ( _
    key As String, _
    value As Object, _
    oldVersion As DataCacheItemVersion, _
    region As String _
) As DataCacheItemVersion
public DataCacheItemVersion Put (
    string key,
    Object value,
    DataCacheItemVersion oldVersion,
    string region
)
public:
DataCacheItemVersion^ Put (
    String^ key, 
    Object^ value, 
    DataCacheItemVersion^ oldVersion, 
    String^ region
)
public DataCacheItemVersion Put (
    String key, 
    Object value, 
    DataCacheItemVersion oldVersion, 
    String region
)
public function Put (
    key : String, 
    value : Object, 
    oldVersion : DataCacheItemVersion, 
    region : String
) : DataCacheItemVersion

パラメーター

  • key
    リージョン内のオブジェクトを識別するために使用される一意の値です。
  • value
    追加または置換するオブジェクトです。
  • oldVersion
    置換されるキャッシュされたオブジェクトのバージョンを表す DataCacheItemVersion オブジェクトです。
  • region
    オブジェクトが存在するリージョンの名前です。

戻り値

key 値の下でキャッシュに保存されるオブジェクトのバージョンを表す DataCacheItemVersion オブジェクトです。

解説

oldVersion パラメーターを渡すことにより、このメソッドは同時実行制御を維持することができます。 このメソッドが呼び出される前に、別のプロセスがキャッシュされたオブジェクトを更新した場合、このメソッドはキャッシュされたオブジェクト更新せず、null を返します。 同時実行の詳細については、「同時実行モデル」および「同時実行メソッド」を参照してください。

このメソッドの使用方法の詳細については、「[HOWTO] キャッシュのオブジェクトの更新」を参照してください。

スレッド セーフ

この型のパブリック静的 (Visual Basic では Shared ) メンバーはスレッド セーフです。インスタンスのメンバーはいずれも、スレッド セーフである保証はありません。

プラットフォーム

開発プラットフォーム

Visual Studio 2010 およびそれ以降, .NET Framework 4

対象プラットフォーム

Windows 7; Windows Server 2008 R2; Windows Server 2008 Service Pack 2; Windows Vista Service Pack 2

関連項目

参照

DataCache クラス
DataCache メンバー
Microsoft.ApplicationServer.Caching 名前空間