DataCache.PutAndUnlock metodo (String, Object, DataCacheLockHandle, TimeSpan, IEnumerable generico, String)

  • Articolo

Sostituisce e sblocca un oggetto nell'area specificata. Specifica il valore di timeout e associa tag all'oggetto memorizzato nella cache.

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

Uso

Sintassi

'Dichiarazione
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

Parametri

  • key
    Il valore univoco utilizzato per identificare l'oggetto nell'area.
  • value
    L'oggetto da aggiungere o sostituire.
  • timeout
    L'intervallo di tempo in cui l'oggetto deve trovarsi nella cache prima della scadenza.
  • tags
    Un elenco di tag da associare all'oggetto.
  • region
    Il nome dell'area in cui si trova l'oggetto.

Valore restituito

Un oggetto DataCacheItemVersion che rappresenta la versione dell'oggetto memorizzato nella cache dopo che è stato aggiornato dal metodo.

Osservazioni

Gli oggetti bloccati non risultano mai scaduti, ma possono scadere immediatamente se sbloccati dopo la scadenza prevista. Per ulteriori informazioni, vedere Scadenza ed eliminazione.

Questo rapporto di overload è utile per aggiornare i tag associati agli oggetti. Per ulteriori informazioni sui metodi disponibili per l'utilizzo dei tag, vedere Metodi basati su tag.

Il valore timeout associato con l'oggetto memorizzato nella cache sostituisce le impostazioni di scadenza specificate nella configurazione della cache denominata. Per ulteriori informazioni, vedere Scadenza ed eliminazione.

Se il parametro lockHandle è diverso dall'oggetto DataCacheLockHandle ottenuto dal metodo utilizzato per bloccare l'oggetto, viene generato un oggetto DataCacheException con la proprietà ErrorCode impostata su InvalidCacheLockHandle e l'oggetto non viene aggiornato.

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