DataCache.PutAndUnlock メソッド (String, Object, DataCacheLockHandle, TimeSpan, String)

指定したリージョン内でオブジェクトの置換またはロック解除を行います。 キャッシュされたオブジェクトのタイムアウト値を指定します。

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

使用法

構文

'宣言
Public Function PutAndUnlock ( _
    key As String, _
    value As Object, _
    lockHandle As DataCacheLockHandle, _
    timeout As TimeSpan, _
    region As String _
) As DataCacheItemVersion

public DataCacheItemVersion PutAndUnlock (
    string key,
    Object value,
    DataCacheLockHandle lockHandle,
    TimeSpan timeout,
    string region
)

public:
DataCacheItemVersion^ PutAndUnlock (
    String^ key, 
    Object^ value, 
    DataCacheLockHandle^ lockHandle, 
    TimeSpan timeout, 
    String^ region
)

public DataCacheItemVersion PutAndUnlock (
    String key, 
    Object value, 
    DataCacheLockHandle lockHandle, 
    TimeSpan timeout, 
    String region
)

public function PutAndUnlock (
    key : String, 
    value : Object, 
    lockHandle : DataCacheLockHandle, 
    timeout : TimeSpan, 
    region : String
) : DataCacheItemVersion

パラメーター

• key
  リージョン内のオブジェクトを識別するために使用される一意の値です。

• value
  追加または置換するオブジェクトです。

• lockHandle
  オブジェクトがロックされた時点で返された DataCacheLockHandle オブジェクトです。

• timeout
  有効期限切れになる前にオブジェクトがキャッシュ内に存在する期間です。

• region
  オブジェクトが存在するリージョンの名前です。

戻り値

このメソッドにより更新された後、キャッシュされたオブジェクトのバージョンを表す DataCacheItemVersion オブジェクトです。 キャッシュされたオブジェクトに関連付けられたタイムアウト値は、名前付きキャッシュの構成で指定されている有効期限の設定を上書きします。 詳細については、「有効期限と削除」を参照してください。

解説

ロックされたオブジェクトは有効期限切れにはなりませんが、有効期限後にロック解除された場合、すぐに有効期限切れになる場合があります。 詳細については、「有効期限と削除」を参照してください。

lockHandle パラメーターが、オブジェクトをロックするために使用されるメソッドから取得される DataCacheLockHandle オブジェクトに等しくない場合、ErrorCode プロパティが InvalidCacheLockHandle に設定された状態で DataCacheException オブジェクトがスローされ、オブジェクトは更新されません。

スレッド セーフ

この型のパブリック静的 (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 名前空間