(String, Object, DataCacheItemVersion, TimeSpan, IEnumerable genérico) de método de DataCache.Put

Agrega o reemplaza un objeto en la memoria caché si se corresponde con la versión especificada. Especifica el valor de tiempo de espera y asocia 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 Put ( _
    key As String, _
    value As Object, _
    oldVersion As DataCacheItemVersion, _
    timeout As TimeSpan, _
    tags As IEnumerable(Of DataCacheTag) _
) As DataCacheItemVersion

public DataCacheItemVersion Put (
    string key,
    Object value,
    DataCacheItemVersion oldVersion,
    TimeSpan timeout,
    IEnumerable<DataCacheTag> tags
)

public:
DataCacheItemVersion^ Put (
    String^ key, 
    Object^ value, 
    DataCacheItemVersion^ oldVersion, 
    TimeSpan timeout, 
    IEnumerable<DataCacheTag^>^ tags
)

public DataCacheItemVersion Put (
    String key, 
    Object value, 
    DataCacheItemVersion oldVersion, 
    TimeSpan timeout, 
    IEnumerable<DataCacheTag> tags
)

public function Put (
    key : String, 
    value : Object, 
    oldVersion : DataCacheItemVersion, 
    timeout : TimeSpan, 
    tags : IEnumerable<DataCacheTag>
) : DataCacheItemVersion

Parámetros

• key
  Valor exclusivo que se usa para identificar el objeto en caché.

• value
  Objeto que se va a agregar o reemplazar.

• oldVersion
  Objeto DataCacheItemVersion que representa la versión del objeto en caché que se va a reemplazar.

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

• tags
  Lista de etiquetas que se asociarán al objeto.

Valor devuelto

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

Comentarios

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 almacena el objeto en una región.

La transferencia del parámetro oldVersion permite que este método mantenga la simultaneidad. Si otro proceso actualiza el objeto en caché antes de invocar este método, el método no actualizará el objeto en caché y devolverá un valor nulo. Para obtener más información sobre la simultaneidad, vea Modelos de simultaneidad y Métodos de simultaneidad.

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 el uso de este método, vea Procedimiento: Actualizar un objeto de 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