IBM WebSphere™ eXtreme Scale Client for .NET Release 8.6.0.0 API Specification
Assembly: Client.Api (in Client.Api.dll) Version: 8.6.0.0
Specification details:
Locks the specified key and retrieves the associated value. If the value is not found, a null is returned.
Namespace: IBM.WebSphere.Caching.MapIf the map supports null values, use the Lock(TKey, LockMode) or the ContainsKey(TKey) to test for a key that might have a null value.
Assembly: Client.Api (in Client.Api.dll) Version: 8.6.0.0
Syntax
Parameters
- key
- Type: TKey
Specifies the key to lock.
- lockMode
- Type: IBM.WebSphere.Caching.Map LockMode
Specifies the type of lock to acquire.
Return Value
Specifies the value that is associated with the specified key if it exists. Otherwise, null is returned.Exceptions
Exception | Condition |
---|---|
System ArgumentException | Occurs when a null key is specified. |
IBM.WebSphere.Caching GridException | Occurs when an error occurs during processing. |
IBM.WebSphere.Caching.Security AccessControlException | Occurs when the caller has insufficient authority to perform this operation. |
Remarks
Required client permission: | MapPermission.READ |
Pessimistic locks acquired: | LockMode.Shared, LockMode.Upgradable or LockMode.Exclusive |
Pessimistic locks held: | Yes |
Cache tier: | Progresses to all tiers until the key is found and the appropriate lock is acquired. |
See Also