Cache.Insert Método

Definición

Espacio de nombres:: System.Web.Caching

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inserta un elemento en el Cache objeto . Use una de las versiones de este método para sobrescribir un elemento existente Cache con el mismo key parámetro.

Sobrecargas

Nombre	Description
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)	Inserta un objeto en el Cache objeto con dependencias, directivas de expiración y prioridad, y un delegado que puede usar para notificar a la aplicación cuando se quita el elemento insertado de `Cache`.
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)	Inserta un objeto en el Cache objeto junto con dependencias, directivas de expiración y un delegado que puede usar para notificar a la aplicación antes de quitar el elemento de la memoria caché.
Insert(String, Object, CacheDependency)	Inserta un objeto en el Cache que tiene dependencias de archivo o clave.
Insert(String, Object)	Inserta un elemento en el Cache objeto con una clave de caché para hacer referencia a su ubicación, utilizando los valores predeterminados proporcionados por la CacheItemPriority enumeración.
Insert(String, Object, CacheDependency, DateTime, TimeSpan)	Inserta un objeto en Cache con dependencias y directivas de expiración.

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)

Inserta un objeto en el Cache objeto con dependencias, directivas de expiración y prioridad, y un delegado que puede usar para notificar a la aplicación cuando se quita el elemento insertado de Cache.

public:
 void Insert(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 void Insert(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.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemPriority * System.Web.Caching.CacheItemRemovedCallback -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, priority As CacheItemPriority, onRemoveCallback As CacheItemRemovedCallback)

Parámetros

key: String

Clave de caché usada para hacer referencia al objeto.

value: Object

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

dependencies: CacheDependency

Dependencias de clave de archivo o caché para el elemento. Cuando cambia cualquier dependencia, el objeto deja de ser válido y se quita de la memoria caché. Si no hay dependencias, este parámetro contiene null.

absoluteExpiration: DateTime

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

slidingExpiration: TimeSpan

Intervalo entre el momento en que se accedió por última vez al objeto insertado y la hora en que expira ese objeto. Si este valor es el equivalente de 20 minutos, el objeto expirará y se quitará de la memoria caché 20 minutos después de que se haya accedido por última vez. Si usa la expiración deslizante, el absoluteExpiration parámetro debe ser NoAbsoluteExpiration.

priority: CacheItemPriority

Costo del objeto en relación con otros elementos almacenados en la memoria caché, como se expresa en la CacheItemPriority enumeración. La memoria caché usa este valor cuando expulsa objetos; Los objetos con un costo menor se quitan de la memoria caché antes de que los objetos con un costo mayor.

onRemoveCallback: CacheItemRemovedCallback

Delegado al que, si se proporciona, se llamará cuando se quite un objeto de la memoria caché. Puede usarlo para notificar a las aplicaciones cuando sus objetos se eliminan de la memoria caché.

Excepciones

ArgumentNullException

El parámetro key o value es null.

ArgumentOutOfRangeException

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

ArgumentException

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

Ejemplos

En el ejemplo siguiente se muestra cómo asignar un elemento de alta prioridad al insertarlo en el objeto de la Cache aplicación.

Note

Para obtener más información sobre cómo usar este método con el CacheItemRemovedCallback delegado, vea Cómo: Notificar a una aplicación cuando se quita un elemento de la memoria caché.

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove);

Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, onRemove)

Comentarios

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

No se pueden establecer los absoluteExpiration parámetros y slidingExpiration . Si piensa que el elemento de caché expire en un momento específico, establezca el absoluteExpiration parámetro en la hora específica y el slidingExpiration parámetro en NoSlidingExpiration.

Si piensa que el elemento de caché expire después de que haya transcurrido una determinada cantidad de tiempo desde el último acceso al elemento, establezca el slidingExpiration parámetro en el intervalo de expiración y el absoluteExpiration parámetro en NoAbsoluteExpiration.

Consulte también

Se aplica a

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)

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

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System::Web::Caching::CacheItemUpdateCallback ^ onUpdateCallback);

public void Insert(string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration, System.Web.Caching.CacheItemUpdateCallback onUpdateCallback);

member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan * System.Web.Caching.CacheItemUpdateCallback -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan, onUpdateCallback As CacheItemUpdateCallback)

Parámetros

key: String

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

value: Object

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

dependencies: CacheDependency

absoluteExpiration: DateTime

Hora en la que expira el objeto insertado y se quita de la memoria caché. Para evitar posibles problemas con la hora local, como los cambios del horario estándar al horario de verano, use UtcNow en lugar de para este valor de Now parámetro. Si usa la expiración absoluta, el slidingExpiration parámetro debe establecerse NoSlidingExpirationen .

slidingExpiration: TimeSpan

Intervalo entre el tiempo en que se accedió por última vez al objeto almacenado en caché y la hora en que expira ese objeto. Si este valor es el equivalente de 20 minutos, el objeto expirará y se quitará de la memoria caché 20 minutos después de que se haya accedido por última vez. Si usa la expiración deslizante, el absoluteExpiration parámetro debe establecerse NoAbsoluteExpirationen .

onUpdateCallback: CacheItemUpdateCallback

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

Excepciones

ArgumentNullException

El keyparámetro , valueo onUpdateCallback es null.

ArgumentOutOfRangeException

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

ArgumentException

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

O bien

El dependencies parámetro es nully el absoluteExpiration parámetro se establece en NoAbsoluteExpirationy el slidingExpiration parámetro se establece en NoSlidingExpiration.

Comentarios

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

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

Si piensa que el elemento de caché expire después de un período de tiempo establecido desde que se accedió por última vez al elemento, establezca el parámetro en slidingExpiration el intervalo de expiración y establezca el absoluteExpiration parámetro NoAbsoluteExpirationen .

Consulte también

CacheItemUpdateCallback

Se aplica a

Insert(String, Object, CacheDependency)

Inserta un objeto en el Cache que tiene dependencias de archivo o clave.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies);

public void Insert(string key, object value, System.Web.Caching.CacheDependency dependencies);

member this.Insert : string * obj * System.Web.Caching.CacheDependency -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency)

Parámetros

key: String

Clave de caché que se usa para identificar el elemento.

value: Object

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

dependencies: CacheDependency

Dependencias de archivo o clave de caché para el objeto insertado. Cuando cambia cualquier dependencia, el objeto deja de ser válido y se quita de la memoria caché. Si no hay dependencias, este parámetro contiene null.

Excepciones

ArgumentNullException

El parámetro key o value es null.

Ejemplos

En el ejemplo siguiente se muestra cómo insertar un elemento en la memoria caché de una aplicación con una dependencia de caché en un archivo de configuración XML.

Cache.Insert("DSN", connectionString, new CacheDependency(Server.MapPath("myconfig.xml")));

Cache.Insert("DSN", connectionString, New CacheDependency(Server.MapPath("myconfig.xml")))

Comentarios

Este método sobrescribirá un elemento de caché existente cuya clave coincide con el key parámetro . El objeto agregado a la memoria caché mediante esta sobrecarga del Insert método se inserta con una prioridad de Default, un valor de expiración deslizante de NoSlidingExpirationy un valor de expiración absoluto de NoAbsoluteExpiration.

Consulte también

CacheDependency

Se aplica a

Insert(String, Object)

Inserta un elemento en el Cache objeto con una clave de caché para hacer referencia a su ubicación, utilizando los valores predeterminados proporcionados por la CacheItemPriority enumeración.

public:
 void Insert(System::String ^ key, System::Object ^ value);

public void Insert(string key, object value);

member this.Insert : string * obj -> unit

Public Sub Insert (key As String, value As Object)

Parámetros

key: String

Clave de caché usada para hacer referencia al elemento.

value: Object

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

Excepciones

ArgumentNullException

El parámetro key o value es null.

Ejemplos

En el ejemplo siguiente se muestra cómo insertar un elemento en la memoria caché de una aplicación.

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

Comentarios

Este método sobrescribirá un elemento de caché existente cuya clave coincide con el key parámetro . El objeto agregado a la memoria caché mediante esta sobrecarga del Insert método se inserta sin dependencias de archivo o caché, una prioridad de Default, un valor de expiración deslizante de NoSlidingExpirationy un valor de expiración absoluto de NoAbsoluteExpiration.

Consulte también

Almacenamiento en caché de datos de la aplicación

Se aplica a

Insert(String, Object, CacheDependency, DateTime, TimeSpan)

Inserta un objeto en Cache con dependencias y directivas de expiración.

public:
 void Insert(System::String ^ key, System::Object ^ value, System::Web::Caching::CacheDependency ^ dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);

public void Insert(string key, object value, System.Web.Caching.CacheDependency dependencies, DateTime absoluteExpiration, TimeSpan slidingExpiration);

member this.Insert : string * obj * System.Web.Caching.CacheDependency * DateTime * TimeSpan -> unit

Public Sub Insert (key As String, value As Object, dependencies As CacheDependency, absoluteExpiration As DateTime, slidingExpiration As TimeSpan)

Parámetros

key: String

Clave de caché usada para hacer referencia al objeto.

value: Object

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

dependencies: CacheDependency

absoluteExpiration: DateTime

slidingExpiration: TimeSpan

Intervalo entre el momento en que se obtiene acceso al objeto insertado por última vez y la hora a la que expira ese objeto. Si este valor es el equivalente de 20 minutos, el objeto expirará y se quitará de la memoria caché 20 minutos después de que se haya accedido por última vez. Si usa la expiración deslizante, el absoluteExpiration parámetro debe ser NoAbsoluteExpiration.

Excepciones

ArgumentNullException

El parámetro key o value es null.

ArgumentOutOfRangeException

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

ArgumentException

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

Ejemplos

En el ejemplo siguiente se muestra cómo insertar un elemento en la memoria caché de una aplicación con una expiración absoluta.

Note

Dado que esta forma del método Insert admite dependencias de caché, si el elemento no tiene dependencias, debe declarar el parámetro dependency como null (Nothing en Visual Basic) en la lista delimitada por comas de parámetros.

Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration);

Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), Cache.NoSlidingExpiration)

En el ejemplo siguiente se muestra cómo insertar un elemento en la memoria caché con una expiración deslizante.

Cache.Insert("DSN", connectionString, null, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10));

Cache.Insert("DSN", connectionString, Nothing, Cache.NoAbsoluteExpiration, TimeSpan.FromSeconds(10))

Comentarios

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

Si el slidingExpiration parámetro se establece NoSlidingExpirationen , la expiración deslizante está deshabilitada. Si establece el slidingExpiration parámetro en mayor que Zero, el absoluteExpiration parámetro se establece en Now más el valor contenido en el slidingExpiration parámetro . Si el elemento se solicita desde la memoria caché antes de la cantidad de tiempo especificada por el absoluteExpiration parámetro , el elemento se volverá a colocar en la memoria caché y absoluteExpiration se volverá a establecer en DateTime.Now más el valor contenido en el slidingExpiration parámetro . Si el elemento no se solicita de la memoria caché antes de la fecha del absoluteExpiration parámetro , el elemento se quita de la memoria caché. El elemento agregado a la memoria caché mediante esta sobrecarga del método insert se inserta con una prioridad de Default.

Consulte también

Se aplica a

Comentarios

¿Le ha resultado útil esta página?