DataCache.GetAndLock メソッド (String, TimeSpan, out DataCacheLockHandle, String, Boolean)

キーが存在し、キーがクライアントによりロックされていない場合、キーをロックし、キーに対応するオブジェクトを返します。 リージョンに格納されているオブジェクトが対象です。

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

使用法

構文

'宣言
Public Function GetAndLock ( _
    key As String, _
    timeout As TimeSpan, _
    <OutAttribute> ByRef lockHandle As DataCacheLockHandle, _
    region As String, _
    forceLock As Boolean _
) As Object

public Object GetAndLock (
    string key,
    TimeSpan timeout,
    out DataCacheLockHandle lockHandle,
    string region,
    bool forceLock
)

public:
Object^ GetAndLock (
    String^ key, 
    TimeSpan timeout, 
    [OutAttribute] DataCacheLockHandle^% lockHandle, 
    String^ region, 
    bool forceLock
)

public Object GetAndLock (
    String key, 
    TimeSpan timeout, 
    /** @attribute OutAttribute() */ /** @ref */ DataCacheLockHandle lockHandle, 
    String region, 
    boolean forceLock
)

パラメーター

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

• timeout
  オブジェクトがロックされたままにする時間の長さです。

• lockHandle
  オブジェクトのロックを解除するために必要な DataCacheLockHandle オブジェクトです。 lockHandle 出力パラメーターは参照により渡されます。

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

• forceLock
  forceLock が true である場合、キャッシュ内のキーと値のペアの存在に関係なく、キーはロックされます。

戻り値

Object が存在し、ロックされていない場合、指定した key パラメーターに一致する Object を返します。

• キーが存在しない場合、ErrorCode が KeyDoesNotExist に設定された状態で DataCacheException オブジェクトがスローされます。 参照されているキーに基づいてオブジェクトを作成し、このエラーを解決します。

• オブジェクトが既に別のキャッシュ クライアントによりロックされている場合、ErrorCode が ObjectLocked に設定された状態で 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 名前空間