ObjectCache.Add Método

Definición

Cuando se invalida en una clase derivada, inserta una entrada de caché sin que sea necesario devolver una entrada existente con la misma clave.When overridden in a derived class, inserts a cache entry into the cache, without requiring that an existing cache entry with a matching key be returned.

Sobrecargas

Add(CacheItem, CacheItemPolicy)

Cuando se reemplaza en una clase derivada, intenta insertar una entrada en la memoria caché como una instancia de CacheItem y agrega detalles sobre cómo debe expulsarse la entrada.When overridden in a derived class, tries to insert a cache entry into the cache as a CacheItem instance, and adds details about how the entry should be evicted.

Add(String, Object, DateTimeOffset, String)

Cuando se invalida en una clase derivada, inserta una entrada de caché en la memoria caché sin sobrescribir ninguna entrada existente.When overridden in a derived class, inserts a cache entry into the cache without overwriting any existing cache entry.

Add(String, Object, CacheItemPolicy, String)

Cuando se invalida en una clase derivada, inserta una entrada de caché en la memoria caché, y especifica información sobre cómo se expulsará la entrada.When overridden in a derived class, inserts a cache entry into the cache, specifying information about how the entry will be evicted.

Comentarios

Las Add sobrecargas del método intentan insertar una entrada de caché en la memoria caché, sin sobrescribir o quitar una entrada de caché existente que tenga la misma clave.The Add method overloads try to insert a cache entry into the cache, without overwriting or removing an existing cache entry that has the same key. La entrada de caché puede ser un objeto con tipo CacheItem o un objeto genérico.The cache entry can be a typed CacheItem object or a generic object.

Las sobrecargas del AddOrGetExisting método y las Add sobrecargas del método tienen una diferencia significativa.The AddOrGetExisting method overloads and the Add method overloads have one significant difference. Cuando estos métodos insertan una entrada de caché, si se encuentra una entrada coincidente en la memoria caché, las AddOrGetExisting sobrecargas del método devuelven la entrada de caché existente, pero las Add sobrecargas del método no lo hacen.When these methods insert a cache entry, if a matching entry is found in the cache, the AddOrGetExisting method overloads return the existing cache entry, but the Add method overloads do not. Tener estas sobrecargas de método diferentes permite a los llamadores optimizar su código en función de si necesitan la entrada de caché existente.Having these different method overloads enables callers to optimize their code based on whether they need the existing cache entry. En las memorias caché distribuidas, devolver un valor existente usando el AddOrGetExisting método puede ser más caro que devolver un valor booleano mediante el Add método.In distributed caches, returning an existing value by using the AddOrGetExisting method might be more expensive than returning a Boolean value by using Add method.

Add(CacheItem, CacheItemPolicy)

Cuando se reemplaza en una clase derivada, intenta insertar una entrada en la memoria caché como una instancia de CacheItem y agrega detalles sobre cómo debe expulsarse la entrada.When overridden in a derived class, tries to insert a cache entry into the cache as a CacheItem instance, and adds details about how the entry should be evicted.

public:
 virtual bool Add(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);
public virtual bool Add (System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);
abstract member Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
override this.Add : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> bool
Public Overridable Function Add (item As CacheItem, policy As CacheItemPolicy) As Boolean

Parámetros

item
CacheItem

Objeto que se va a agregar.The object to add.

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

Boolean

Es true si la inserción se realiza correctamente; es false si ya hay una entrada en la memoria caché que tiene la misma clave que item.true if insertion succeeded, or false if there is an already an entry in the cache that has the same key as item.

Comentarios

Las Add sobrecargas del método son virtuales (no abstractas) en la ObjectCache clase, porque el Add método llama internamente a AddOrGetExisting .The Add method overloads are virtual (not abstract) on the ObjectCache class, because the Add method internally calls AddOrGetExisting. Esto reduce el número de sobrecargas de método que un implementador de caché tiene que proporcionar.This reduces the number of method overloads that a cache implementer has to provide. Si una implementación de caché no requiere ningún comportamiento especial para el Add método, solo puede implementar las AddOrGetExisting sobrecargas del método.If a cache implementation does not require any special behavior for the Add method, it can just implement the AddOrGetExisting method overloads.

Se aplica a

Add(String, Object, DateTimeOffset, String)

Cuando se invalida en una clase derivada, inserta una entrada de caché en la memoria caché sin sobrescribir ninguna entrada existente.When overridden in a derived class, inserts a cache entry into the cache without overwriting any existing cache entry.

public virtual bool Add (string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);
abstract member Add : string * obj * DateTimeOffset * string -> bool
override this.Add : string * obj * DateTimeOffset * string -> bool
Public Overridable Function Add (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing) As Boolean

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. Este parámetro es necesario cuando se llama al método Add.This parameter is required when the Add method is called.

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. Dado que las regiones no se implementan en .NET Framework 4, el valor predeterminado es null .Because regions are not implemented in .NET Framework 4, the default value is null.

Devoluciones

Boolean

Es true si la inserción se realiza correctamente; es false si ya hay una entrada en la memoria caché que tiene la misma clave que key.true if insertion succeeded, or false if there is an already an entry in the cache that has the same key as key.

Comentarios

Las Add sobrecargas del método son virtuales (no abstractas) en la ObjectCache clase, porque el Add método llama internamente a AddOrGetExisting .The Add method overloads are virtual (not abstract) on the ObjectCache class, because the Add method internally calls AddOrGetExisting. Esto reduce el número de sobrecargas de método que un implementador de caché tiene que proporcionar.This reduces the number of method overloads that a cache implementer has to provide. Si una implementación de caché no requiere ningún comportamiento especial para el Add método, solo puede implementar las AddOrGetExisting sobrecargas del método.If a cache implementation does not require any special behavior for the Add method, it can just implement the AddOrGetExisting method overloads.

Se aplica a

Add(String, Object, CacheItemPolicy, String)

Cuando se invalida en una clase derivada, inserta una entrada de caché en la memoria caché, y especifica información sobre cómo se expulsará la entrada.When overridden in a derived class, inserts a cache entry into the cache, specifying information about how the entry will be evicted.

public virtual bool Add (string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);
abstract member Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
override this.Add : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> bool
Public Overridable Function Add (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing) As Boolean

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

Boolean

Es true si el intento de inserción se realiza correctamente; es false si ya hay una entrada en la memoria caché que tiene la misma clave que key.true if the insertion try succeeds, or false if there is an already an entry in the cache with the same key as key.

Comentarios

Las Add sobrecargas del método son virtuales (no abstractas) en la ObjectCache clase, porque el Add método llama internamente a AddOrGetExisting .The Add method overloads are virtual (not abstract) on the ObjectCache class, because the Add method internally calls AddOrGetExisting. Esto reduce el número de sobrecargas de método que un implementador de caché tiene que proporcionar.This reduces the number of method overloads that a cache implementer has to provide. Si una implementación de caché no requiere ningún comportamiento especial para el Add método, solo puede implementar las AddOrGetExisting sobrecargas del método.If a cache implementation does not require any special behavior for the Add method, it can just implement the AddOrGetExisting method overloads.

Se aplica a