DataCache.GetAndLock metodo (String, TimeSpan, out DataCacheLockHandle, Boolean)

Articolo
01/26/2011

Blocca la chiave se questa è presente e non è bloccata da alcun client, quindi restituisce l'oggetto a essa corrispondente.

Spazio dei nomi: Microsoft.ApplicationServer.Caching
Assembly: Microsoft.ApplicationServer.Caching.Client (in microsoft.applicationserver.caching.client.dll)

Uso

Sintassi

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

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

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

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

Parametri

key
Il valore univoco utilizzato per identificare l'oggetto nell'area.

timeout
Il periodo di tempo in cui l'oggetto resta bloccato.

lockHandle
L'oggetto DataCacheLockHandle necessario per sbloccare l'oggetto. Il parametro di output lockHandle viene passato per riferimento.

forceLock
Se forceLock è true, la chiave viene bloccata indipendentemente dalla presenza della coppia chiave-valore nella cache.

Valore restituito

Restituisce un oggetto Object corrispondente al parametro key specificato se tale Object esiste e non è bloccato.

Se la chiave non esiste, viene generato un oggetto DataCacheException con il codice ErrorCode impostato su KeyDoesNotExist. Per correggere l'errore, creare oggetti in base alla chiave a cui si fa riferimento.
Se l'oggetto è già bloccato da un altro client della cache, viene generato un oggetto DataCacheException con il codice ErrorCode impostato su ObjectLocked. L'oggetto sarà inaccessibile fino a quando non verrà sbloccato dal client che lo ha bloccato.

Protezione thread

Qualsiasi membro statico (condiviso in Visual Basic) di questo tipo è thread safe, diversamente dai membri istanza.

Piattaforme

Piattaforme di sviluppo

Visual Studio 2010 e versioni successive, .NET Framework 4

Piattaforme di destinazione

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

Vedere anche

Informazioni di riferimento

Classe DataCache
DataCache membri
Spazio dei nomi Microsoft.ApplicationServer.Caching

Condividi tramite