(String, Object, IEnumerable genérico) de método de DataCache.Add

Artículo
01/26/2011

Agrega un objeto a la memoria caché. Este método permite asociar etiquetas al objeto en caché.

Espacio de nombres: Microsoft.ApplicationServer.Caching
Ensamblado: Microsoft.ApplicationServer.Caching.Client (en microsoft.applicationserver.caching.client.dll)

Uso

Sintaxis

'Declaración
Public Function Add ( _
    key As String, _
    value As Object, _
    tags As IEnumerable(Of DataCacheTag) _
) As DataCacheItemVersion

public DataCacheItemVersion Add (
    string key,
    Object value,
    IEnumerable<DataCacheTag> tags
)

public:
DataCacheItemVersion^ Add (
    String^ key, 
    Object^ value, 
    IEnumerable<DataCacheTag^>^ tags
)

public DataCacheItemVersion Add (
    String key, 
    Object value, 
    IEnumerable<DataCacheTag> tags
)

public function Add (
    key : String, 
    value : Object, 
    tags : IEnumerable<DataCacheTag>
) : DataCacheItemVersion

Parámetros

key
Valor exclusivo que se usa para almacenar y recuperar el objeto en la memoria caché.

value
Objeto guardado en el clúster de caché.

tags
Matriz de objetos DataCacheTag que se va a asociar al objeto en caché.

Valor devuelto

Objeto DataCacheItemVersion que representa la versión del objeto guardado en caché bajo el valor key.

Comentarios

Si ya existe un elemento en caché que usa la misma clave, la llamada producirá una excepción del tipo DataCacheException con ErrorCode definido en KeyAlreadyExists. Las opciones de expiración se derivan de la configuración de la memoria caché con nombre.

Las etiquetas se pueden usar solamente para recuperar un objeto en caché si dicho objeto se encuentra almacenado en una región. Esta sobrecarga no guarda el objeto en una región.

Seguridad para subprocesos

Todos los miembros públicos y estáticos (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

Visual Studio 2010 y posterior, .NET Framework 4

Plataformas de destino

Windows 7; Windows Server 2008 R2; Windows Server 2008 Service Pack 2; Windows Vista Service Pack 2

Vea también

Referencia

Clase de DataCache
Miembros de DataCache
Espacio de nombres de Microsoft.ApplicationServer.Caching

Compartir vía