DataCache.Put metodo (String, Object, DataCacheItemVersion, TimeSpan, String)

Aggiunge o sostituisce un oggetto nell'area specificata se la versione di quest'ultimo corrisponde alla versione specificata. Specifica il valore di timeout dell'oggetto memorizzato nella cache.

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

public DataCacheItemVersion Put (
	string key,
	Object value,
	DataCacheItemVersion oldVersion,
	TimeSpan timeout,
	string region
)
public DataCacheItemVersion Put (
	String key, 
	Object value, 
	DataCacheItemVersion oldVersion, 
	TimeSpan timeout, 
	String region
)
public function Put (
	key : String, 
	value : Object, 
	oldVersion : DataCacheItemVersion, 
	timeout : TimeSpan, 
	region : String
) : DataCacheItemVersion

Parametri

key

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

value

L'oggetto da aggiungere o sostituire.

oldVersion

L'oggetto DataCacheItemVersion che rappresenta la versione dell'oggetto memorizzato nella cache da sostituire.

timeout

L'intervallo di tempo in cui l'oggetto deve trovarsi nella cache prima della scadenza.

region

Il nome dell'area in cui si trova l'oggetto.

Valore restituito

Un oggetto DataCacheItemVersion che rappresenta la versione dell'oggetto salvato nella cache sotto il valore key.

Se si passa il parametro oldVersion, questo metodo può gestire la concorrenza. Se l'oggetto memorizzato nella cache viene aggiornato da un altro processo prima che venga chiamato questo metodo, quest'ultimo non aggiornerà l'oggetto memorizzato nella cache e restituirà null. Per ulteriori informazioni sulla concorrenza, vedere Modelli di concorrenza e Metodi di concorrenza.

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.

Per ulteriori informazioni sull'utilizzo di questo metodo, vedere Procedure: Aggiornare un oggetto nella cache.


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: