Insert Método (String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)
Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Cache.Insert (Método) (String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)

.NET Framework (current version)
 

Inserta un objeto en el objeto Cache junto con las dependencias, las directivas de expiración y un delegado que puede usar para notificar a la aplicación antes de que se quite el elemento de la memoria caché.

Espacio de nombres:   System.Web.Caching
Ensamblado:  System.Web (en System.Web.dll)

public void Insert(
	string key,
	object value,
	CacheDependency dependencies,
	DateTime absoluteExpiration,
	TimeSpan slidingExpiration,
	CacheItemUpdateCallback onUpdateCallback
)

Parámetros

key

Clave de caché que se utiliza para hacer referencia al objeto.

value

Objeto que se va a insertar en la memoria caché.

dependencies

Dependencias de archivo o de clave de caché para el elemento.Cuando cambia alguna dependencia, el objeto ya no es válido y se quita de la caché.Si no hay ninguna dependencia, este parámetro contiene null.

absoluteExpiration

Hora a la que el objeto insertado expira y se quita de la memoria caché.Para evitar posibles problemas con la hora local, como cambios de la hora estándar al horario de verano, utilice UtcNow en lugar de Now para este valor de parámetro.Si se utiliza una expiración absoluta, el parámetro slidingExpiration debe estar establecido en NoSlidingExpiration.

slidingExpiration

Intervalo entre la hora a la que se obtuvo acceso por última vez al objeto almacenado en caché y la hora a la que expira dicho objeto.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.Si se utiliza una expiración variable, el parámetro absoluteExpiration debe estar establecido en NoAbsoluteExpiration.

onUpdateCallback

Delegado al que se llamará antes de que se quite el objeto de la memoria caché.Puede utilizarlo para actualizar el elemento almacenado en caché y asegurarse de que no se quite de la memoria caché.

Exception Condition
ArgumentNullException

Los parámetros key, value o onUpdateCallback son null.

ArgumentOutOfRangeException

Se establece el parámetro slidingExpiration en un valor menor que TimeSpan.Zero o en el equivalente a más de un año.

ArgumentException

Los parámetros absoluteExpiration y slidingExpiration se establecen ambos para el elemento que se intenta agregar a Cache.

-o-

El parámetro dependencies está establecido en null, el parámetro absoluteExpiration está establecido en NoAbsoluteExpiration y el parámetro slidingExpiration está establecido en NoSlidingExpiration.

El método Insert permite insertar un nuevo elemento en la memoria caché y proporcionar un delegado al que se va a llamar antes de que se quite el elemento de la memoria caché.En el delegado, se puede actualizar el elemento almacenado en caché y, por lo tanto, evitar que se quite de la memoria caché.

Este método sobrescribirá un elemento Cache existente con el mismo parámetro key.

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 memoria caché expire después de transcurrir un período de tiempo establecido desde la última vez que se obtuvo acceso al elemento, establezca el parámetro slidingExpiration en el intervalo de expiración y establezca el parámetro absoluteExpiration en NoAbsoluteExpiration.

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar:
© 2016 Microsoft