ObjectCache.AddOrGetExisting Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cuando se reemplaza en una clase derivada, intenta insertar una entrada en la memoria caché y devuelve una entrada existente con la misma clave.
Sobrecargas
AddOrGetExisting(CacheItem, CacheItemPolicy) |
Cuando se invalida en una clase derivada, inserta el objeto CacheItem especificado en la memoria caché, y especifica información sobre cómo se expulsará la entrada. |
AddOrGetExisting(String, Object, DateTimeOffset, String) |
Cuando se invalida en una clase derivada, inserta una entrada de caché en la memoria caché utilizando una clave, un objeto para la entrada de caché, un valor de expiración absoluto y una región opcional a la que se va a agregar la entrada. |
AddOrGetExisting(String, Object, CacheItemPolicy, String) |
Cuando se invalida en una clase derivada, inserta una entrada de caché en la memoria caché, y especifica una clave y un valor para la entrada, así como información sobre cómo va a expulsarse. |
Comentarios
El AddOrGetExisting método sobrecarga inserta una entrada en la memoria caché. Si ya existe una entrada de caché con una clave coincidente, devuelven la entrada existente. La entrada de caché puede ser un CacheItem objeto o un objeto genérico.
Hay una diferencia entre las AddOrGetExisting sobrecargas y las Add sobrecargas. Cuando estos métodos sobrecargados intentan insertar una entrada de caché, si se encuentra una entrada existente que tiene una clave que coincide con una entrada de caché insertada existente, las AddOrGetExisting sobrecargas devuelven la entrada de caché existente. Las Add sobrecargas no.
AddOrGetExisting(CacheItem, CacheItemPolicy)
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
Cuando se invalida en una clase derivada, inserta el objeto CacheItem especificado en la memoria caché, y especifica información sobre cómo se expulsará la entrada.
public:
abstract System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ value, System::Runtime::Caching::CacheItemPolicy ^ policy);
public abstract System.Runtime.Caching.CacheItem AddOrGetExisting (System.Runtime.Caching.CacheItem value, System.Runtime.Caching.CacheItemPolicy policy);
abstract member AddOrGetExisting : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> System.Runtime.Caching.CacheItem
Public MustOverride Function AddOrGetExisting (value As CacheItem, policy As CacheItemPolicy) As CacheItem
Parámetros
- value
- CacheItem
Objeto que se va a insertar.
- policy
- CacheItemPolicy
Objeto que contiene detalles sobre la expulsión de la entrada de caché. Este objeto proporciona más opciones de expulsión que una simple expiración absoluta.
Devoluciones
Si existe una entrada de caché con la misma clave, se devuelve la entrada de caché especificada; de lo contrario, se devuelve null
.
Se aplica a
AddOrGetExisting(String, Object, DateTimeOffset, String)
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
Cuando se invalida en una clase derivada, inserta una entrada de caché en la memoria caché utilizando una clave, un objeto para la entrada de caché, un valor de expiración absoluto y una región opcional a la que se va a agregar la entrada.
public abstract object AddOrGetExisting (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);
abstract member AddOrGetExisting : string * obj * DateTimeOffset * string -> obj
Public MustOverride Function AddOrGetExisting (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Object
Parámetros
- key
- String
Identificador único de la entrada de caché.
- value
- Object
Objeto que se va a insertar.
- absoluteExpiration
- DateTimeOffset
Fecha y hora fijas a las que expirará la entrada de caché.
- regionName
- String
Opcional. Región con nombre de la memoria caché a la que se puede agregar la entrada si se implementan regiones. El valor predeterminado para el parámetro opcional es null
.
Devoluciones
Si ya existe una entrada de caché con la misma clave, se devuelve el valor de la entrada de caché especificada; de lo contrario, se devuelve null
.
Comentarios
Esta AddOrGetExisting(String, Object, DateTimeOffset, String) sobrecarga de método devuelve un valor de objeto, no un CacheItem objeto .
Se aplica a
AddOrGetExisting(String, Object, CacheItemPolicy, String)
- Source:
- ObjectCache.cs
- Source:
- ObjectCache.cs
Cuando se invalida en una clase derivada, inserta una entrada de caché en la memoria caché, y especifica una clave y un valor para la entrada, así como información sobre cómo va a expulsarse.
public abstract object AddOrGetExisting (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);
abstract member AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> obj
Public MustOverride Function AddOrGetExisting (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Object
Parámetros
- key
- String
Identificador único de la entrada de caché.
- value
- Object
Objeto que se va a insertar.
- policy
- CacheItemPolicy
Objeto que contiene detalles sobre la expulsión de la entrada de caché. Este objeto proporciona más opciones de expulsión que una simple expiración absoluta.
- regionName
- String
Opcional. Región con nombre de la memoria caché a la que se puede agregar la entrada si se implementan regiones. El valor predeterminado para el parámetro opcional es null
.
Devoluciones
Si ya existe una entrada de caché con la misma clave, se devuelve el valor de la entrada de caché especificada; de lo contrario, se devuelve null
.
Comentarios
El AddOrGetExisting(String, Object, CacheItemPolicy, String) método devuelve un valor de objeto, no un CacheItem objeto .