DataCache.Put metodo (String, Object, DataCacheItemVersion, IEnumerable generico, String)

Aggiunge o sostituisce un oggetto nell'area specificata se la versione di quest'ultimo corrisponde alla versione specificata. 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 Put (
	string key,
	Object value,
	DataCacheItemVersion oldVersion,
	IEnumerable<DataCacheTag> tags,
	string region
)
public DataCacheItemVersion Put (
	String key, 
	Object value, 
	DataCacheItemVersion oldVersion, 
	IEnumerable<DataCacheTag> tags, 
	String region
)
public function Put (
	key : String, 
	value : Object, 
	oldVersion : DataCacheItemVersion, 
	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.

oldVersion

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

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 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.

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.

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: