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

Sostituisce e sblocca un oggetto nella cache. 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)

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

Parametri

key

Il valore univoco utilizzato per identificare l'oggetto nella cache.

value

L'oggetto da aggiungere o sostituire.

lockHandle

L'oggetto DataCacheLockHandle restituito al momento del blocco dell'oggetto.

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.

Valore restituito

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

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

È possibile utilizzare i tag per recuperare un oggetto memorizzato nella cache solo se questo è memorizzato in un'area. Questo overload non salva l'oggetto in un'area.

Il valore di timeout associato all'oggetto memorizzato nella cache ha la priorità sulle impostazioni relative alla 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.


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

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
Mostra: