ObjectCache.AddOrGetExisting Método

Definición

Cuando se reemplaza en una clase derivada, intenta insertar una entrada en la memoria caché y devuelve una entrada existente con la misma clave.When overridden in a derived class, tries to insert a cache entry into the cache, and returns an existing cache entry with a matching key.

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.When overridden in a derived class, inserts the specified CacheItem object into the cache, specifying information about how the entry will be evicted.

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.When overridden in a derived class, inserts a cache entry into the cache, by using a key, an object for the cache entry, an absolute expiration value, and an optional region to add the cache into.

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.When overridden in a derived class, inserts a cache entry into the cache, specifying a key and a value for the cache entry, and information about how the entry will be evicted.

Comentarios

Las AddOrGetExisting sobrecargas del método insertan una entrada en la memoria caché.The AddOrGetExisting method overloads insert an entry into the cache. Si ya existe una entrada de caché con una clave coincidente, devolverá la entrada existente.If a cache entry with a matching key already exists, they return the existing entry. La entrada de caché puede ser un CacheItem objeto o un objeto genérico.The cache entry can be a CacheItem object or a generic object.

Existe una diferencia entre las AddOrGetExisting sobrecargas y las Add sobrecargas.There is one difference between the AddOrGetExisting overloads and the Add overloads. 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.When these overloaded methods try to insert a cache entry, if an existing entry is found that has a key that matches an existing inserted cache entry, the AddOrGetExisting overloads return the existing cache entry. Las Add sobrecargas no lo hacen.The Add overloads do not.

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.When overridden in a derived class, inserts the specified CacheItem object into the cache, specifying information about how the entry will be evicted.

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.The object to insert.

policy
CacheItemPolicy

Objeto que contiene detalles sobre la expulsión de la entrada de caché.An object that contains eviction details for the cache entry. Este objeto proporciona más opciones de expulsión que una simple expiración absoluta.This object provides more options for eviction than a simple absolute expiration.

Devoluciones

CacheItem

Si existe una entrada de caché con la misma clave, se devuelve la entrada de caché especificada; de lo contrario, se devuelve null.If a cache entry with the same key exists, the specified cache entry; otherwise, null.

Se aplica a

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.When overridden in a derived class, inserts a cache entry into the cache, by using a key, an object for the cache entry, an absolute expiration value, and an optional region to add the cache into.

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é.A unique identifier for the cache entry.

value
Object

Objeto que se va a insertar.The object to insert.

absoluteExpiration
DateTimeOffset

Fecha y hora fijas a las que expirará la entrada de caché.The fixed date and time at which the cache entry will expire.

regionName
String

Opcional.Optional. Región con nombre de la memoria caché a la que se puede agregar la entrada si se implementan regiones.A named region in the cache to which the cache entry can be added, if regions are implemented. El valor predeterminado para el parámetro opcional es null.The default value for the optional parameter is null.

Devoluciones

Object

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.If a cache entry with the same key exists, the specified cache entry's value; otherwise, null.

Comentarios

Esta AddOrGetExisting(String, Object, DateTimeOffset, String) sobrecarga del método devuelve un valor de objeto, no un CacheItem objeto.This AddOrGetExisting(String, Object, DateTimeOffset, String) method overload returns an object value, not a CacheItem object.

Se aplica a

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.When overridden in a derived class, inserts a cache entry into the cache, specifying a key and a value for the cache entry, and information about how the entry will be evicted.

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é.A unique identifier for the cache entry.

value
Object

Objeto que se va a insertar.The object to insert.

policy
CacheItemPolicy

Objeto que contiene detalles sobre la expulsión de la entrada de caché.An object that contains eviction details for the cache entry. Este objeto proporciona más opciones de expulsión que una simple expiración absoluta.This object provides more options for eviction than a simple absolute expiration.

regionName
String

Opcional.Optional. Región con nombre de la memoria caché a la que se puede agregar la entrada si se implementan regiones.A named region in the cache to which the cache entry can be added, if regions are implemented. El valor predeterminado para el parámetro opcional es null.The default value for the optional parameter is null.

Devoluciones

Object

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.If a cache entry with the same key exists, the specified cache entry's value; otherwise, null.

Comentarios

El AddOrGetExisting(String, Object, CacheItemPolicy, String) método devuelve un valor de objeto, no un CacheItem objeto.The AddOrGetExisting(String, Object, CacheItemPolicy, String) method returns an object value, not a CacheItem object.

Se aplica a