Calls to this method will fail if an item with the same key parameter is already stored in the Cache. To overwrite an existing Cache item using the same key parameter, use the Insert method.

You cannot set both the absoluteExpiration and slidingExpiration parameters. If you intend the cache item to expire at a specific time, you set the absoluteExpiration parameter to the specific time, and the slidingExpiration parameter to NoSlidingExpiration.

If you intend the cache item to expire after a certain amount of time has passed since the item was last accessed, you set the slidingExpiration parameter to the expiration interval, and the absoluteExpiration parameter to NoAbsoluteExpiration.

The following example creates an AddItemToCache method. When this method is called, it sets an itemRemoved property to false and registers an onRemove method with a new instance of the CacheItemRemovedCallback delegate. The delegate's signature is used in the RemovedCallback method. The AddItemToCache method then checks the value associated with the Key1 key in the cache. If the value is nullNothingnullptra null reference (Nothing in Visual Basic), the Add method places an item in the cache with a key of Key1, a value of Value 1, an absolute expiration of 60 seconds, and a high cache priority. It also uses the onRemove method as an argument. This allows the RemovedCallback method to be called when this item is removed from the cache.

Note
For examples of how to use the CacheDependency class and the CacheItemRemovedCallback delegate, see Caching Application Data.

Public Sub AddItemToCache(sender As Object, e As EventArgs)
    itemRemoved = false

    onRemove = New CacheItemRemovedCallback(AddressOf Me.RemovedCallback)

    If (IsNothing(Cache("Key1"))) Then
      Cache.Add("Key1", "Value 1", Nothing, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove)
    End If
End Sub

public void AddItemToCache(Object sender, EventArgs e) {
    itemRemoved = false;

    onRemove = new CacheItemRemovedCallback(this.RemovedCallback);

    if (Cache["Key1"] == null)
      Cache.Add("Key1", "Value 1", null, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove);
}

.NET Framework

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role not supported), Windows Server 2003 SP2

Reference

Other Resources

Las llamadas a este método generarán un error si un elemento con el mismo parámetro key ya está almacenado en Cache. Para reemplazar un elemento Cache existente mediante el mismo parámetro key, utilice el método Insert.

No puede establecer los parámetros absoluteExpiration y slidingExpiration al mismo tiempo. Si desea que el elemento de la caché expire a una hora determinada, establezca el parámetro absoluteExpiration en esa hora y el parámetro slidingExpiration en NoSlidingExpiration.

Si desea que el elemento de la caché expire después de transcurrido un período de tiempo determinado a partir del momento en que se haya tenido acceso a él por última vez, establezca el parámetro slidingExpiration en el intervalo de expiración y el parámetro absoluteExpiration en NoAbsoluteExpiration.

En el siguiente ejemplo se crea un método AddItemToCache. Cuando se llama a este método, establece una propiedad itemRemoved en false y registra un método onRemove con una nueva instancia del delegado CacheItemRemovedCallback. La firma del delegado se utiliza en el método RemovedCallback. A continuación, el método AddItemToCache comprueba el valor asociado a la clave Key1 de la caché. Si el valor es nullNothingnullptrreferencia null (Nothing en Visual Basic), el método Add coloca un elemento en la caché con una clave de Key1, un valor de Value 1, un período de expiración absoluta de 60 segundos y una prioridad de caché alta. También utiliza el método onRemove como argumento. Esto permite llamar el método RemovedCallback cuando se quita este elemento de la caché.

Nota
Para obtener ejemplos de cómo utilizar la clase CacheDependency y el delegado CacheItemRemovedCallback, vea Almacenar en caché datos de la aplicación.

Public Sub AddItemToCache(sender As Object, e As EventArgs)
    itemRemoved = false

    onRemove = New CacheItemRemovedCallback(AddressOf Me.RemovedCallback)

    If (IsNothing(Cache("Key1"))) Then
      Cache.Add("Key1", "Value 1", Nothing, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove)
    End If
End Sub

public void AddItemToCache(Object sender, EventArgs e) {
    itemRemoved = false;

    onRemove = new CacheItemRemovedCallback(this.RemovedCallback);

    if (Cache["Key1"] == null)
      Cache.Add("Key1", "Value 1", null, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove);
}

.NET Framework

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia

Otros recursos