Cache.Insert Método
Definición
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 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 |
| 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 -> unitPublic 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
El parámetro key o value es null.
Se establece el parámetro slidingExpiration en un valor menor que TimeSpan.Zero o en el equivalente a más de un año.
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 alta prioridad 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 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 tiene previsto 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 cantidad determinada 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
Se aplica a
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 -> unitPublic 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
El key, value o el parámetro onUpdateCallback es null.
Se establece el parámetro slidingExpiration en un valor menor que TimeSpan.Zero o en el equivalente a más de un año.
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, impedir 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 tiene previsto 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 el último acceso al elemento, establezca el slidingExpiration parámetro en el intervalo de expiración y establezca el absoluteExpiration parámetro NoAbsoluteExpirationen .
Consulte también
Se aplica a
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 -> unitPublic 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
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
Se aplica a
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 -> unitPublic 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
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 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
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 -> unitPublic 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
El parámetro key o value es null.
Se establece el parámetro slidingExpiration en un valor menor que TimeSpan.Zero o en el equivalente a más de un año.
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
Dado 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 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 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 especificado por el absoluteExpiration parámetro , el elemento se volverá a colocar en la memoria caché y absoluteExpiration se volverá a DateTime.Now establecer 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
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de