DataCache.Add metodo (String, Object, TimeSpan, IEnumerable generico, String)
Aggiunge un oggetto a un'area della cache. Mediante questo metodo è possibile associare tag all'oggetto memorizzato nella cache e specificare la scadenza dell'oggetto.
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, _
timeout As TimeSpan, _
tags As IEnumerable(Of DataCacheTag), _
region As String _
) As DataCacheItemVersion
public DataCacheItemVersion Add (
string key,
Object value,
TimeSpan timeout,
IEnumerable<DataCacheTag> tags,
string region
)
public:
DataCacheItemVersion^ Add (
String^ key,
Object^ value,
TimeSpan timeout,
IEnumerable<DataCacheTag^>^ tags,
String^ region
)
public DataCacheItemVersion Add (
String key,
Object value,
TimeSpan timeout,
IEnumerable<DataCacheTag> tags,
String region
)
public function Add (
key : String,
value : Object,
timeout : TimeSpan,
tags : IEnumerable<DataCacheTag>,
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.
- timeout
L'intervallo di tempo in cui l'oggetto deve trovarsi nella cache prima della scadenza.
- tags
Una matrice di oggetti DataCacheTag da associare all'oggetto memorizzato nella 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 la cache 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.
Il valore di timeout associato all'oggetto memorizzato nella cache ha la priorità sulle impostazioni relative alla scadenza specificate nella 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