(String, Object, TimeSpan, String) de método de DataCache.Add

Agrega un objeto a una región de la memoria caché. Este método ofrece la posibilidad de especificar cuándo debe expirar el objeto.

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, _
    timeout As TimeSpan, _
    region As String _
) As DataCacheItemVersion

public DataCacheItemVersion Add (
    string key,
    Object value,
    TimeSpan timeout,
    string region
)

public:
DataCacheItemVersion^ Add (
    String^ key, 
    Object^ value, 
    TimeSpan timeout, 
    String^ region
)

public DataCacheItemVersion Add (
    String key, 
    Object value, 
    TimeSpan timeout, 
    String region
)

public function Add (
    key : String, 
    value : Object, 
    timeout : TimeSpan, 
    region : String
) : 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é.

• timeout
  Tiempo que el objeto debe residir en la memoria caché antes de su expiración.

• region
  Nombre de la región en la que se guardará el objeto.

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 la región que usa la misma clave, la llamada iniciará una excepción del tipo DataCacheException con ErrorCode definido en KeyAlreadyExists.

El valor timeout asociado al objeto en caché reemplaza las opciones de expiración especificadas en la configuración de la memoria caché con nombre. Para obtener más información, vea Caducidad y expulsión. Para obtener más información sobre cómo usar este método, vea Procedimiento: Agregar un objeto a la memoria caché.

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