(String, Object, DataCacheLockHandle, TimeSpan, IEnumerable genérico, String) de método de DataCache.PutAndUnlock

Artículo
01/26/2011

Reemplaza y desbloquea un objeto en la región especificada. Especifica el valor de tiempo de espera y asocia etiquetas al objeto en caché.

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

Uso

Sintaxis

'Declaración
Public Function PutAndUnlock ( _
    key As String, _
    value As Object, _
    lockHandle As DataCacheLockHandle, _
    timeout As TimeSpan, _
    tags As IEnumerable(Of DataCacheTag), _
    region As String _
) As DataCacheItemVersion

public DataCacheItemVersion PutAndUnlock (
    string key,
    Object value,
    DataCacheLockHandle lockHandle,
    TimeSpan timeout,
    IEnumerable<DataCacheTag> tags,
    string region
)

public:
DataCacheItemVersion^ PutAndUnlock (
    String^ key, 
    Object^ value, 
    DataCacheLockHandle^ lockHandle, 
    TimeSpan timeout, 
    IEnumerable<DataCacheTag^>^ tags, 
    String^ region
)

public DataCacheItemVersion PutAndUnlock (
    String key, 
    Object value, 
    DataCacheLockHandle lockHandle, 
    TimeSpan timeout, 
    IEnumerable<DataCacheTag> tags, 
    String region
)

public function PutAndUnlock (
    key : String, 
    value : Object, 
    lockHandle : DataCacheLockHandle, 
    timeout : TimeSpan, 
    tags : IEnumerable<DataCacheTag>, 
    region : String
) : DataCacheItemVersion

Parámetros

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

value
Objeto que se va a agregar o reemplazar.

lockHandle
Objeto DataCacheLockHandle devuelto mientras el objeto estaba bloqueado.

timeout
Tiempo que el objeto debe residir en la memoria caché antes de su expiración.

tags
Lista de etiquetas que se asociarán al objeto.

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

Valor devuelto

Objeto DataCacheItemVersion que representa la versión del objeto en caché después de su actualización mediante este método.

Comentarios

Los objetos bloqueados nunca expiran, pero pueden expirar inmediatamente si se desbloquean después de su hora de expiración. Para obtener más información, vea Caducidad y expulsión.

Esta sobrecarga resulta útil para actualizar las etiquetas asociadas al objeto. Para obtener más información acerca de los métodos disponibles para usar etiquetas, vea Métodos basados en etiquetas.

El valor de tiempo de espera asociado al objeto en caché reemplaza las opciones de expiración especificadas en la configuración de la memoria caché con nombre. Para obtener más información, vea Caducidad y expulsión.

Si el parámetro lockHandle no es igual al objeto DataCacheLockHandle obtenido con el método que se usa para bloquear el objeto, se produce un objeto DataCacheException con la propiedad ErrorCode definida en InvalidCacheLockHandle y el objeto no se actualiza.

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