(String, TimeSpan, out DataCacheLockHandle, String) de método de DataCache.GetAndLock

Artículo
01/26/2011

Bloquea la clave si esta está presente y no está bloqueada y devuelve el objeto correspondiente a dicha clave. Para los objetos almacenados en regiones.

Espacio de nombres: Microsoft.ApplicationServer.Caching
Ensamblado: Microsoft.ApplicationServer.Caching.Client (en microsoft.applicationserver.caching.client.dll)

Uso

Sintaxis

'Declaración
Public Function GetAndLock ( _
    key As String, _
    timeout As TimeSpan, _
    <OutAttribute> ByRef lockHandle As DataCacheLockHandle, _
    region As String _
) As Object

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

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

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

Parámetros

key
Valor exclusivo que se usa para identificar el objeto en la región.

timeout
Tiempo que el objeto permanece bloqueado.

lockHandle
Objeto DataCacheLockHandle necesario para desbloquear el objeto. El parámetro de salida lockHandle se transfiere a modo de referencia.

region
Nombre de la región en la que reside el objeto.

Valor devuelto

Devuelve Object coincidente con el parámetro key especificado si Object ya existe y no está bloqueado.

Si la clave no existe, se inicia un objeto DataCacheException con ErrorCode definido en KeyDoesNotExist. Cree objetos basados en la clave de referencia para resolver este error.
Si otro cliente de caché ya ha bloqueado el objeto, se inicia un objeto DataCacheException con ErrorCode definido como ObjectLocked. El objeto será inaccesible hasta que el cliente que lo ha bloqueado lo desbloquee.

Comentarios

Se producen errores en otras llamadas del método GetAndLock al mismo error de objeto mientras el bloqueo es válido. Las llamadas normales del método Get no se bloquean y siempre obtienen acceso a la última versión del objeto almacenado en caché. Para obtener más información sobre la simultaneidad, vea Modelos de simultaneidad y Métodos de simultaneidad.

Seguridad para subprocesos

Todos los miembros públicos y estáticos (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

Visual Studio 2010 y posterior, .NET Framework 4

Plataformas de destino

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

Vea también

Referencia

Clase de DataCache
Miembros de DataCache
Espacio de nombres de Microsoft.ApplicationServer.Caching

Compartir vía