MemoryCache.AddOrGetExisting Método

Definición

Espacio de nombres:

System.Runtime.Caching

Ensamblado:

System.Runtime.Caching.dll

Paquete:

System.Runtime.Caching v11.0.0-preview.2.26159.112

Inserta una entrada de caché en la memoria caché.

Sobrecargas

Nombre	Description
AddOrGetExisting(CacheItem, CacheItemPolicy)	Agrega una entrada de caché a la memoria caché mediante la instancia especificada CacheItem y detalles sobre cómo expulsar la entrada.
AddOrGetExisting(String, Object, DateTimeOffset, String)	Agrega una entrada de caché a la memoria caché mediante la clave especificada y un valor y un valor de expiración absoluto.
AddOrGetExisting(String, Object, CacheItemPolicy, String)	Inserta una entrada de caché en la memoria caché mediante la clave y el valor especificados y los detalles especificados sobre cómo se va a expulsar.

Comentarios

Las AddOrGetExisting sobrecargas del método se usan para insertar una entrada de caché en la memoria caché. Si no existe una entrada de caché con una clave coincidente, estos métodos insertan una nueva entrada. Si ya existe una entrada de caché con una clave coincidente, devuelven la entrada existente.

AddOrGetExisting(CacheItem, CacheItemPolicy)

Source:

MemoryCache.cs

Agrega una entrada de caché a la memoria caché mediante la instancia especificada CacheItem y detalles sobre cómo expulsar la entrada.

public:
 override System::Runtime::Caching::CacheItem ^ AddOrGetExisting(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public override System.Runtime.Caching.CacheItem AddOrGetExisting(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

override this.AddOrGetExisting : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> System.Runtime.Caching.CacheItem

Public Overrides Function AddOrGetExisting (item As CacheItem, policy As CacheItemPolicy) As CacheItem

Parámetros

item

CacheItem

Objeto que se va a agregar.

policy

CacheItemPolicy

Objeto que contiene detalles de expulsión para la entrada de caché. Este objeto proporciona más opciones para la expulsión que una expiración absoluta simple.

Devoluciones

CacheItem

Si existe una entrada de caché con la misma clave, la entrada de caché existente; de lo contrario, null.

Excepciones

ArgumentNullException

La Value propiedad es null.

ArgumentException

Los valores de expiración absolutos y deslizantes para el CacheItemPolicy objeto se establecen en valores distintos de los valores predeterminados de InfiniteAbsoluteExpiration y NoSlidingExpiration . La MemoryCache clase no puede establecer la directiva de expiración basada en una combinación de una expiración absoluta y una expiración deslizante. Solo se puede establecer explícitamente una configuración de expiración cuando se usa la MemoryCache instancia. El otro valor de expiración debe establecerse en InfiniteAbsoluteExpiration campo o NoSlidingExpiration campo.

ArgumentOutOfRangeException

La SlidingExpiration propiedad se establece en un valor menor que Zero.

O bien

La SlidingExpiration propiedad se establece en un valor mayor de un año.

O bien

La Priority propiedad no es un valor de la CacheItemPriority enumeración.

Comentarios

El item parámetro proporciona la clave y el valor que usa el método . Si la memoria caché tiene una entrada de caché con la misma clave que la clave del item parámetro , el método devuelve la entrada existente como una CacheItem instancia. Si no hay ninguna entrada de caché existente, el método crea uno nuevo mediante la clave y el valor proporcionados por el item parámetro y con los detalles de expulsión especificados por policy.

Advertencia

Las Add sobrecargas de método y AddOrGetExisting no admiten la UpdateCallback propiedad . Por lo tanto, para establecer la UpdateCallback propiedad de una entrada de caché, use en su lugar las sobrecargas del Set método.

AddOrGetExisting(String, Object, DateTimeOffset, String)

Source:

MemoryCache.cs

Agrega una entrada de caché a la memoria caché mediante la clave especificada y un valor y un valor de expiración absoluto.

public override object AddOrGetExisting(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

override this.AddOrGetExisting : string * obj * DateTimeOffset * string -> obj

Public Overrides 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é que se va a agregar.

value

Object

Datos de la entrada de caché.

absoluteExpiration

DateTimeOffset

Fecha y hora fijas en las que expirará la entrada de caché.

regionName

String

Región con nombre en la memoria caché a la que se puede agregar una entrada de caché. No pase un valor para este parámetro. Este parámetro es null de forma predeterminada, ya que la MemoryCache clase no implementa regiones.

Devoluciones

Object

Si existe una entrada de caché con la misma clave, la entrada de caché existente; de lo contrario, null.

Excepciones

ArgumentNullException

value no nulles .

NotSupportedException

regionName no nulles .

ArgumentException

Los valores de expiración absolutos y deslizantes para el CacheItemPolicy objeto se establecen en valores distintos de los valores predeterminados de InfiniteAbsoluteExpiration y NoSlidingExpiration . La MemoryCache clase no puede establecer la directiva de expiración basada en una combinación de una expiración absoluta y una expiración deslizante. Solo se puede establecer explícitamente una configuración de expiración cuando se usa la MemoryCache instancia. La otra configuración de expiración debe establecerse en InfiniteAbsoluteExpiration o NoSlidingExpiration

ArgumentOutOfRangeException

La SlidingExpiration propiedad se establece en un valor menor que Zero.

O bien

La SlidingExpiration propiedad se establece en un valor mayor de un año.

O bien

La Priority propiedad no es un valor de la CacheItemPriority enumeración.

Comentarios

Si la memoria caché no tiene una entrada de caché cuya clave coincide con el key parámetro , se crea una nueva entrada de caché y la sobrecarga del MemoryCache.AddOrGetExisting método devuelve null. Si existe una entrada de caché coincidente, se devuelve la entrada existente.

Advertencia

Las Add sobrecargas de método y AddOrGetExisting no admiten la UpdateCallback propiedad . Por lo tanto, para establecer la UpdateCallback propiedad de una entrada de caché, use en su lugar las sobrecargas del Set método.

AddOrGetExisting(String, Object, CacheItemPolicy, String)

Source:

MemoryCache.cs

Inserta una entrada de caché en la memoria caché mediante la clave y el valor especificados y los detalles especificados sobre cómo se va a expulsar.

public override object AddOrGetExisting(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

override this.AddOrGetExisting : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> obj

Public Overrides 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é que se va a agregar o obtener.

value

Object

Datos de la entrada de caché.

policy

CacheItemPolicy

Objeto que contiene detalles de expulsión para la entrada de caché. Este objeto proporciona más opciones para la expulsión que una expiración absoluta simple.

regionName

String

Región con nombre en la memoria caché a la que se puede agregar una entrada de caché. No pase un valor para este parámetro. De forma predeterminada, este parámetro es null, porque la MemoryCache clase no implementa regiones.

Devoluciones

Object

Si ya existe una entrada de caché coincidente, una entrada de caché; de lo contrario, null.

Excepciones

ArgumentNullException

value es null.

ArgumentException

Los valores de expiración absolutos y deslizantes del CacheItemPolicy objeto se establecen en valores distintos de los valores predeterminados de InfiniteAbsoluteExpiration y NoSlidingExpiration. La MemoryCache clase no puede establecer la directiva de expiración en función de una combinación de una expiración absoluta y deslizante. Solo se puede establecer explícitamente una configuración de expiración cuando se usa la MemoryCache clase . La otra configuración debe establecerse en InfiniteAbsoluteExpiration o NoSlidingExpiration.

O bien

Tanto la devolución de llamada de eliminación como la devolución de llamada de actualización se han especificado para CacheItemPolicy. Solo MemoryCache admite el uso de un tipo de devolución de llamada por entrada de caché.

ArgumentOutOfRangeException

La SlidingExpiration propiedad se establece en un valor menor que Zero.

O bien

se SlidingExpiration ha establecido en un valor mayor de un año.

O bien

La Priority propiedad no es un valor de la CacheItemPriority enumeración.

Comentarios

Advertencia

Las Add sobrecargas de método y AddOrGetExisting no admiten la UpdateCallback propiedad . Por lo tanto, para establecer la UpdateCallback propiedad de una entrada de caché, use en su lugar las sobrecargas del Set método.