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

Aggiunge o sostituisce un oggetto nella cache 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)

Uso

Sintassi

'Dichiarazione
Public Function Put ( _
    key As String, _
    value As Object, _
    oldVersion As DataCacheItemVersion, _
    timeout As TimeSpan _
) As DataCacheItemVersion

public DataCacheItemVersion Put (
    string key,
    Object value,
    DataCacheItemVersion oldVersion,
    TimeSpan timeout
)

public:
DataCacheItemVersion^ Put (
    String^ key, 
    Object^ value, 
    DataCacheItemVersion^ oldVersion, 
    TimeSpan timeout
)

public DataCacheItemVersion Put (
    String key, 
    Object value, 
    DataCacheItemVersion oldVersion, 
    TimeSpan timeout
)

public function Put (
    key : String, 
    value : Object, 
    oldVersion : DataCacheItemVersion, 
    timeout : TimeSpan
) : 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.

Valore restituito

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

Osservazioni

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.

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