Condividi tramite


DataCache.Add metodo (String, Object, String)

Aggiunge un oggetto a un'area della cache.

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

Uso

Sintassi

'Dichiarazione
Public Function Add ( _
    key As String, _
    value As Object, _
    region As String _
) As DataCacheItemVersion
public DataCacheItemVersion Add (
    string key,
    Object value,
    string region
)
public:
DataCacheItemVersion^ Add (
    String^ key, 
    Object^ value, 
    String^ region
)
public DataCacheItemVersion Add (
    String key, 
    Object value, 
    String region
)
public function Add (
    key : String, 
    value : Object, 
    region : String
) : DataCacheItemVersion

Parametri

  • key
    Un valore univoco utilizzato per archiviare e recuperare l'oggetto dalla cache.
  • value
    L'oggetto salvato nel cluster di cache.
  • region
    Il nome dell'area in cui salvare l'oggetto.

Valore restituito

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

Osservazioni

Se l'area contiene già un elemento che utilizza la stessa chiave, la chiamata restituisce un'eccezione di tipo DataCacheException in cui la proprietà ErrorCode impostata su KeyAlreadyExists. Le impostazioni relative alla scadenza derivano dalla configurazione della cache denominata. Per ulteriori informazioni, vedere Scadenza ed eliminazione. Per ulteriori informazioni su come utilizzare questo metodo, vedere Procedure: Aggiungere un oggetto alla 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