Cache.Add(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) Cache.Add(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) Cache.Add(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) Cache.Add(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) Method

Definición

Agrega el elemento especificado al objeto Cache con directivas de dependencias, expiración y prioridad, así como un delegado que se puede utilizar para notificar a la aplicación cuándo el elemento insertado se quita de la memoria Cache.Adds the specified item to the Cache object with dependencies, expiration and priority policies, and a delegate you can use to notify your application when the inserted item is removed from the Cache.

public:
 System::Object ^ Add(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemPriority priority, System::Web::Caching::CacheItemRemovedCallback ^ onRemoveCallback);
public object Add (string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemPriority priority, System.Web.Caching.CacheItemRemovedCallback onRemoveCallback);
member this.Add : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> obj
Public Function Add (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback) As Object

Parámetros

key
String String String String

Clave de caché utilizada para hacer referencia al elemento.The cache key used to reference the item.

value
Object Object Object Object

Elemento que se va a agregar a la memoria caché.The item to be added to the cache.

dependencies
CacheDependency CacheDependency CacheDependency CacheDependency

Dependencias de archivo o de clave de caché para el elemento.The file or cache key dependencies for the item. Cuando cambia alguna dependencia, el objeto ya no es válido y se quita de la caché.When any dependency changes, the object becomes invalid and is removed from the cache. Si no hay ninguna dependencia, este parámetro contiene null.If there are no dependencies, this parameter contains null.

absoluteExpiration
DateTime DateTime DateTime DateTime

Hora a la que el objeto agregado expira y se quita de la memoria caché.The time at which the added object expires and is removed from the cache. Si se utiliza una expiración variable, el parámetro absoluteExpiration debe ser NoAbsoluteExpiration.If you are using sliding expiration, the absoluteExpiration parameter must be NoAbsoluteExpiration.

slidingExpiration
TimeSpan TimeSpan TimeSpan TimeSpan

Intervalo entre la hora a la que se obtuvo por última vez acceso al objeto agregado y la hora a la que expira dicho objeto.The interval between the time the added object was last accessed and the time at which that object expires. Si este valor es el equivalente a 20 minutos, el objeto expirará y se quitará de la memoria caché a los 20 minutos del último acceso.If this value is the equivalent of 20 minutes, the object expires and is removed from the cache 20 minutes after it is last accessed. Si se utiliza una expiración absoluta, el parámetro slidingExpiration debe ser NoSlidingExpiration.If you are using absolute expiration, the slidingExpiration parameter must be NoSlidingExpiration.

priority
CacheItemPriority CacheItemPriority CacheItemPriority CacheItemPriority

Costo relativo del objeto, expresado por la enumeración de CacheItemPriority.The relative cost of the object, as expressed by the CacheItemPriority enumeration. La memoria caché utiliza este valor cuando extrae objetos; los objetos de costo inferior se quitan de la memoria caché antes que los objetos con un costo más elevado.The cache uses this value when it evicts objects; objects with a lower cost are removed from the cache before objects with a higher cost.

onRemoveCallback
CacheItemRemovedCallback CacheItemRemovedCallback CacheItemRemovedCallback CacheItemRemovedCallback

Delegado al que, si se proporciona, se llama cuando se quita un objeto de la memoria caché.A delegate that, if provided, is called when an object is removed from the cache. Se puede utilizar para notificar a las aplicaciones cuándo se eliminan los objetos de la memoria caché.You can use this to notify applications when their objects are deleted from the cache.

Devoluciones

Objeto que representa el elemento que se agregó si el elemento estaba almacenado anteriormente en la memoria caché; de lo contrario, null.An object that represents the item that was added if the item was previously stored in the cache; otherwise, null.

Excepciones

El parámetro key o value se establece en null.The key or value parameter is set to null.

El parámetro slidingExpiration se establece en un valor menor que TimeSpan.Zero o en más de un año.The slidingExpiration parameter is set to less than TimeSpan.Zero or more than one year.

Los parámetros absoluteExpiration y slidingExpiration se establecen ambos para el elemento que se intenta agregar a Cache.The absoluteExpiration and slidingExpiration parameters are both set for the item you are trying to add to the Cache.

Ejemplos

En el ejemplo siguiente se AddItemToCache crea un método.The following example creates an AddItemToCache method. Cuando se llama a este método, establece una itemRemoved propiedad en false y registra un onRemove método con una nueva instancia del CacheItemRemovedCallback delegado.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. La firma del delegado se usa en el RemovedCallback método.The delegate's signature is used in the RemovedCallback method. A AddItemToCache continuación, el método comprueba el valor asociado Key1 a la clave en la memoria caché.The AddItemToCache method then checks the value associated with the Key1 key in the cache. Si el valor es null, el Add método coloca un elemento en la memoria caché con una clave Key1de, un valor Value 1de, una expiración absoluta de 60 segundos y una prioridad de caché alta.If the value is null, 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. También usa el onRemove método como argumento.It also uses the onRemove method as an argument. Esto permite RemovedCallback llamar al método cuando este elemento se quita de la memoria caché.This allows the RemovedCallback method to be called when this item is removed from the cache.

Nota

Para obtener ejemplos de cómo usar la CacheDependency clase y el CacheItemRemovedCallback delegado, vea almacenar en caché datosde la aplicación.For examples of how to use the CacheDependency class and the CacheItemRemovedCallback delegate, see Caching Application Data.

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);
}
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

Comentarios

key LasCachellamadas a este método producirán un error en modo silencioso si un elemento con el mismo parámetro ya está almacenado en.Calls to this method will fail silently if an item with the same key parameter is already stored in the Cache. Para sobrescribir un elemento existente Cache con el mismo key parámetro, use el Insert método.To overwrite an existing Cache item using the same key parameter, use the Insert method.

No se pueden establecer los absoluteExpiration parámetros slidingExpiration y.You cannot set both the absoluteExpiration and slidingExpiration parameters. Si desea que el elemento de caché expire en un momento determinado, establezca el absoluteExpiration parámetro en la hora específica y el slidingExpiration parámetro en NoSlidingExpiration.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.

Si desea que el elemento de la memoria caché expire después de que haya transcurrido un período de tiempo determinado desde que se produjo el último acceso slidingExpiration al elemento, establezca el parámetro en el absoluteExpiration intervalo de NoAbsoluteExpirationexpiración y el parámetro en.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.

Se aplica a

Consulte también: