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)

Uso

Sintassi

'Dichiarazione
Public Function Put ( _
    key As String, _
    value As Object, _
    oldVersion As DataCacheItemVersion, _
    tags As IEnumerable(Of DataCacheTag), _
    region As String _
) As DataCacheItemVersion

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

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.

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.

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