Cache.Insert Método

Definición

Espacio de nombres:

System.Web.Caching

Ensamblado:

System.Web.dll

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

Sobrecargas

Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)	Inserta un objeto en el 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 se quita de la memoria Cache el elemento insertado.
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)	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é.
Insert(String, Object, CacheDependency)	Inserta un objeto en Cache que tiene dependencias de archivo o de clave.
Insert(String, Object)	Inserta un elemento en el objeto Cache con una clave de caché para hacer referencia a su ubicación y utilizando los valores predeterminados que proporciona la enumeración de CacheItemPriority.
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 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 se quita de la memoria Cache el elemento insertado.

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é utilizada para hacer referencia al objeto.

value

Object

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

dependencies

CacheDependency

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

DateTime

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 ser NoSlidingExpiration.

slidingExpiration

TimeSpan

Intervalo entre la hora a la que se obtuvo por última vez acceso al objeto insertado y la hora a la que expira dicho objeto. Si este valor equivale a 20 minutos, el objeto expirará y se quitará de la memoria caché 20 minutos después del último acceso al mismo. Si se utiliza una expiración variable, el parámetro absoluteExpiration debe ser NoAbsoluteExpiration.

priority

CacheItemPriority

Costo del objeto con respecto a otros elementos almacenados en la memoria caché, expresado por la enumeración de CacheItemPriority. 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.

onRemoveCallback

CacheItemRemovedCallback

Delegado al que, si se proporciona, se llama cuando se quita un objeto de la memoria caché. Se puede utilizar para notificar a las aplicaciones cuándo se eliminan los objetos de la memoria caché.

Excepciones

ArgumentNullException

El parámetro key o value es 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.

Ejemplos

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

Nota

Para obtener más información sobre cómo usar este método con el CacheItemRemovedCallback delegado, vea Cómo: Notificar 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

• DateTime
• TimeSpan
• CacheItemPriority
• CacheItemRemovedCallback
• Almacenamiento en caché de datos de la aplicación

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

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é.

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 utiliza para hacer referencia al objeto.

value

Object

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

dependencies

CacheDependency

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

DateTime

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

TimeSpan

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 equivale a 20 minutos, el objeto expirará y se quitará de la memoria caché 20 minutos después del último acceso al mismo. Si se utiliza una expiración variable, el parámetro absoluteExpiration debe estar establecido en NoAbsoluteExpiration.

onUpdateCallback

CacheItemUpdateCallback

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é.

Excepciones

ArgumentNullException

El key, value o el parámetro onUpdateCallback es 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 bien

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.

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, evitar que se quite de la memoria caché.

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 un período de tiempo establecido desde que se accedió por última vez al elemento, establezca el slidingExpiration parámetro en el intervalo de expiración y establezca el absoluteExpiration parámetro NoAbsoluteExpirationen .

Consulte también

• CacheItemUpdateCallback

Insert(String, Object, CacheDependency)

Inserta un objeto en Cache que tiene dependencias de archivo o de 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é utilizada para identificar el elemento.

value

Object

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

dependencies

CacheDependency

Dependencias de archivo o de clave de caché para el objeto insertado. 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.

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 coincida 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

Insert(String, Object)

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

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é utilizada 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 coincida con el key parámetro . El objeto agregado a la memoria caché mediante esta sobrecarga del Insert método se inserta sin dependencias de archivos 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

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é utilizada para hacer referencia al objeto.

value

Object

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

dependencies

CacheDependency

Dependencias de archivo o de clave de caché para el objeto insertado. 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

DateTime

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 ser NoSlidingExpiration.

slidingExpiration

TimeSpan

El intervalo entre la hora del último acceso al objeto insertado y la hora de expiración de dicho objeto. Si este valor equivale a 20 minutos, el objeto expirará y se quitará de la memoria caché 20 minutos después del último acceso al mismo. Si se utiliza una expiración variable, el parámetro absoluteExpiration debe ser NoAbsoluteExpiration.

Excepciones

ArgumentNullException

El parámetro key o value es 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.

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.

Nota

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

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 Now en 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 establecerá DateTime.Now de nuevo en 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

• DateTime
• TimeSpan
• Almacenamiento en caché de datos de la aplicación