ObjectCache.Add Método

Definición

Espacio de nombres:
System.Runtime.Caching
Ensamblado:
System.Runtime.Caching.dll

Cuando se reemplaza en una clase derivada, inserta una entrada de caché en la memoria caché, sin necesidad de que se devuelva una entrada de caché existente con una clave coincidente.

Sobrecargas

Nombre Description
Add(CacheItem, CacheItemPolicy)

Cuando se invalida en una clase derivada, intenta insertar una entrada de caché en la memoria caché como una CacheItem instancia y agrega detalles sobre cómo se debe expulsar la entrada.
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 de caché existente.
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.

Comentarios

Las Add sobrecargas del método intentan insertar una entrada de caché en la memoria caché, sin sobrescribir ni quitar una entrada de caché existente que tenga la misma clave. La entrada de caché puede ser un objeto con CacheItem tipo o un objeto genérico.

Las AddOrGetExisting sobrecargas del método y las sobrecargas del Add método tienen una diferencia significativa. 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 sobrecargas del Add método no. Tener estas diferentes sobrecargas de método permite a los autores de llamadas optimizar su código en función de si necesitan la entrada de caché existente. En las memorias caché distribuidas, devolver un valor existente mediante el AddOrGetExisting método puede ser más caro que devolver un valor booleano mediante el Add método .

Add(CacheItem, CacheItemPolicy)

Cuando se invalida en una clase derivada, intenta insertar una entrada de caché en la memoria caché como una CacheItem instancia y agrega detalles sobre cómo se debe expulsar la entrada.

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.

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

Boolean

true si la inserción se realizó correctamente o false si ya hay una entrada en la memoria caché que tiene la misma clave que item.

Comentarios

Las Add sobrecargas del método son virtuales (no abstractas) en la ObjectCache clase , ya que el Add método llama internamente a AddOrGetExisting. Esto reduce el número de sobrecargas de método que debe proporcionar un implementador de caché. Si una implementación de caché no requiere ningún comportamiento especial para el Add método , simplemente puede implementar las sobrecargas del AddOrGetExisting método.

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 de caché existente.

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 para la entrada de caché.

value
Object

Objeto que se va a insertar.

absoluteExpiration
DateTimeOffset

Fecha y hora fijas en las que expirará la entrada de caché. Este parámetro es necesario cuando se llama al Add método .

regionName
String

Opcional. Región con nombre en la memoria caché a la que se puede agregar la entrada de caché, si se implementan regiones. Dado que las regiones no se implementan en .NET Framework 4, el valor predeterminado es null.

Devoluciones

Boolean

true si la inserción se realizó correctamente o false si ya hay una entrada en la memoria caché que tiene la misma clave que key.

Comentarios

Las Add sobrecargas del método son virtuales (no abstractas) en la ObjectCache clase , ya que el Add método llama internamente a AddOrGetExisting. Esto reduce el número de sobrecargas de método que debe proporcionar un implementador de caché. Si una implementación de caché no requiere ningún comportamiento especial para el Add método , simplemente puede implementar las sobrecargas del AddOrGetExisting método.

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.

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 para la entrada de caché.

value
Object

Objeto que se va a insertar.

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

Opcional. Región con nombre en la memoria caché a la que se puede agregar la entrada de caché, si se implementan regiones. El valor predeterminado para el parámetro opcional es null.

Devoluciones

Boolean

true si la inserción se realiza correctamente o false si ya hay una entrada en la memoria caché con la misma clave que key.

Comentarios

Las Add sobrecargas del método son virtuales (no abstractas) en la ObjectCache clase , ya que el Add método llama internamente a AddOrGetExisting. Esto reduce el número de sobrecargas de método que debe proporcionar un implementador de caché. Si una implementación de caché no requiere ningún comportamiento especial para el Add método , simplemente puede implementar las sobrecargas del AddOrGetExisting método.

Se aplica a