Cache.Insert Méthode

Définition

Insère un élément dans l'objet Cache.Inserts an item into the Cache object. Utilisez l'une des versions de cette méthode pour remplacer un élément Cache existant par le même paramètre key.Use one of the versions of this method to overwrite an existing Cache item with the same key parameter.

Surcharges

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

Ajoute un objet au Cache avec des dépendances, des stratégies d'expiration et de priorité, ainsi qu'un délégué que vous pouvez utiliser pour avertir votre application lorsque l'élément inséré est supprimé du Cache.Inserts an object into 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.

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

Ajoute un objet à l'objet Cache avec des dépendances, des stratégies d'expiration et un délégué que vous pouvez utiliser pour avertir l'application avant que l'élément ne soit supprimé du cache.Inserts an object into the Cache object together with dependencies, expiration policies, and a delegate that you can use to notify the application before the item is removed from the cache.

Insert(String, Object, CacheDependency)

Insère un objet dans le Cache qui présente des dépendances de fichier ou de clé.Inserts an object into the Cache that has file or key dependencies.

Insert(String, Object)

Insère un élément dans l'objet Cache avec une clé de cache pour faire référence à son emplacement, en utilisant les valeurs par défaut fournies par l'énumération CacheItemPriority.Inserts an item into the Cache object with a cache key to reference its location, using default values provided by the CacheItemPriority enumeration.

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

Insère un objet dans le Cache avec des dépendances et des stratégies d'expiration.Inserts an object into the Cache with dependencies and expiration policies.

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

Ajoute un objet au Cache avec des dépendances, des stratégies d'expiration et de priorité, ainsi qu'un délégué que vous pouvez utiliser pour avertir votre application lorsque l'élément inséré est supprimé du Cache.Inserts an object into 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:
 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)

Paramètres

key
String

Clé du cache utilisée pour faire référence à l'objet.The cache key used to reference the object.

value
Object

Objet à insérer dans le cache.The object to be inserted in the cache.

dependencies
CacheDependency

Dépendances de fichier ou de clé de cache pour l'élément considéré.The file or cache key dependencies for the item. Lorsqu'une dépendance change, l'objet n'est plus valide et est supprimé du cache.When any dependency changes, the object becomes invalid and is removed from the cache. En l'absence de dépendances, ce paramètre contient null.If there are no dependencies, this parameter contains null.

absoluteExpiration
DateTime

Moment auquel l'objet inséré expire et est supprimé du cache.The time at which the inserted object expires and is removed from the cache. Pour éviter d'éventuels problèmes avec l'heure locale, par exemple lors des passages de l'heure d'hiver à l'heure d'été, utilisez UtcNow au lieu de Now pour cette valeur de paramètre.To avoid possible issues with local time such as changes from standard time to daylight saving time, use UtcNow rather than Now for this parameter value. Si vous utilisez l'expiration absolue, le paramètre slidingExpiration doit être NoSlidingExpiration.If you are using absolute expiration, the slidingExpiration parameter must be NoSlidingExpiration.

slidingExpiration
TimeSpan

Intervalle entre le dernier accès à l'objet inséré et le moment où cet objet expire.The interval between the time the inserted object was last accessed and the time at which that object expires. Si cette valeur est équivalente à 20 minutes, l’objet expire et est supprimé du cache 20 minutes après son dernier accès.If this value is the equivalent of 20 minutes, the object will expire and be removed from the cache 20 minutes after it was last accessed. Si vous utilisez l'expiration décalée, le paramètre absoluteExpiration doit être NoAbsoluteExpiration.If you are using sliding expiration, the absoluteExpiration parameter must be NoAbsoluteExpiration.

priority
CacheItemPriority

Coût de l'objet par rapport aux autres éléments stockés dans le cache, exprimé par l'énumération CacheItemPriority.The cost of the object relative to other items stored in the cache, as expressed by the CacheItemPriority enumeration. Le cache utilise cette valeur lorsqu'il évince des objets ; les objets de moindre coût sont supprimés du cache avant les objets de coût supérieur.This value is used by the cache when it evicts objects; objects with a lower cost are removed from the cache before objects with a higher cost.

onRemoveCallback
CacheItemRemovedCallback

Délégué qui, s'il est fourni, est appelé lorsqu'un objet est supprimé du cache.A delegate that, if provided, will be called when an object is removed from the cache. Vous pouvez l'utiliser pour notifier aux applications que leurs objets sont supprimés du cache.You can use this to notify applications when their objects are deleted from the cache.

Exceptions

Le paramètre key ou value est null.The key or value parameter is null.

Vous avez affecté au paramètre slidingExpiration une valeur inférieure à TimeSpan.Zero, ou l'équivalent de plus d'une année.You set the slidingExpiration parameter to less than TimeSpan.Zero or the equivalent of more than one year.

Les paramètres absoluteExpiration et slidingExpiration sont tous deux définis pour l'élément que vous tentez d'ajouter au Cache.The absoluteExpiration and slidingExpiration parameters are both set for the item you are trying to add to the Cache.

Exemples

L’exemple suivant montre comment assigner un élément de priorité haute quand vous l’insérez dans l’objet de votre application Cache .The following example demonstrates how to assign an item high priority when you insert it into your application's Cache object.

Notes

Pour plus d’informations sur l’utilisation de cette méthode avec le CacheItemRemovedCallback délégué, consultez Comment : notifier une application lorsqu’un élément est supprimé du cache.For more information about how to use this method with the CacheItemRemovedCallback delegate, see How to: Notify an Application When an Item Is Removed from the Cache.

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)

Remarques

Cette méthode remplacera un élément existant Cache par le même key paramètre.This method will overwrite an existing Cache item with the same key parameter.

Vous ne pouvez pas définir à la fois les absoluteExpiration slidingExpiration paramètres et.You cannot set both the absoluteExpiration and slidingExpiration parameters. Si vous voulez que l’élément de cache expire à un moment donné, vous affectez au absoluteExpiration paramètre l’heure spécifique et au slidingExpiration paramètre la valeur 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 vous voulez que l’élément de cache expire au bout d’un certain laps de temps écoulé depuis le dernier accès à l’élément, définissez le slidingExpiration paramètre sur l’intervalle d’expiration et le absoluteExpiration paramètre sur NoAbsoluteExpiration .If you intend the cache item to expire after a certain amount of time has passed since the last access to the item, you set the slidingExpiration parameter to the expiration interval, and the absoluteExpiration parameter to NoAbsoluteExpiration.

Voir aussi

S’applique à

Produit Introduit

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

Ajoute un objet à l'objet Cache avec des dépendances, des stratégies d'expiration et un délégué que vous pouvez utiliser pour avertir l'application avant que l'élément ne soit supprimé du cache.Inserts an object into the Cache object together with dependencies, expiration policies, and a delegate that you can use to notify the application before the item is removed from the cache.

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)

Paramètres

key
String

Clé du cache utilisée pour faire référence à l'objet.The cache key that is used to reference the object.

value
Object

Objet à insérer dans le cache.The object to insert into the cache.

dependencies
CacheDependency

Dépendances de fichier ou de clé de cache pour l'élément considéré.The file or cache key dependencies for the item. Lorsqu'une dépendance change, l'objet n'est plus valide et est supprimé du cache.When any dependency changes, the object becomes invalid and is removed from the cache. En l'absence de dépendances, ce paramètre contient null.If there are no dependencies, this parameter contains null.

absoluteExpiration
DateTime

Moment auquel l'objet inséré expire et est supprimé du cache.The time at which the inserted object expires and is removed from the cache. Pour éviter d'éventuels problèmes avec l'heure locale, par exemple lors des passages de l'heure d'hiver à l'heure d'été, utilisez UtcNow au lieu de Now pour cette valeur de paramètre.To avoid possible issues with local time such as changes from standard time to daylight saving time, use UtcNow instead of Now for this parameter value. Si vous utilisez l'expiration absolue, le paramètre slidingExpiration doit avoir la valeur NoSlidingExpiration.If you are using absolute expiration, the slidingExpiration parameter must be set to NoSlidingExpiration.

slidingExpiration
TimeSpan

Intervalle entre l'heure du dernier accès à l'objet en cache et le moment où cet objet expire.The interval between the time that the cached object was last accessed and the time at which that object expires. Si cette valeur est équivalente à 20 minutes, l’objet expire et est supprimé du cache 20 minutes après son dernier accès.If this value is the equivalent of 20 minutes, the object will expire and be removed from the cache 20 minutes after it was last accessed. Si vous utilisez l'expiration décalée, le paramètre absoluteExpiration doit avoir la valeur NoAbsoluteExpiration.If you are using sliding expiration, the absoluteExpiration parameter must be set to NoAbsoluteExpiration.

onUpdateCallback
CacheItemUpdateCallback

Délégué qui est appelé avant qu'un objet ne soit supprimé du cache.A delegate that will be called before the object is removed from the cache. Vous pouvez l'utiliser pour mettre à jour l'élément en cache et vous assurer qu'il ne soit pas supprimé du cache.You can use this to update the cached item and ensure that it is not removed from the cache.

Exceptions

Le paramètre key, value ou onUpdateCallback est null.The key, value, or onUpdateCallback parameter is null.

Vous avez affecté au paramètre slidingExpiration une valeur inférieure à TimeSpan.Zero, ou l'équivalent de plus d'une année.You set the slidingExpiration parameter to less than TimeSpan.Zero or the equivalent of more than one year.

Les paramètres absoluteExpiration et slidingExpiration sont tous deux définis pour l'élément que vous tentez d'ajouter au Cache.The absoluteExpiration and slidingExpiration parameters are both set for the item you are trying to add to the Cache.

- ou --or-

Le paramètre dependencies est null, le paramètre absoluteExpiration a la valeur NoAbsoluteExpiration, et le paramètre slidingExpiration a la valeur NoSlidingExpiration.The dependencies parameter is null, and the absoluteExpiration parameter is set to NoAbsoluteExpiration, and the slidingExpiration parameter is set to NoSlidingExpiration.

Remarques

La Insert méthode vous permet d’insérer un nouvel élément dans le cache et de fournir un délégué qui est appelé avant que l’élément ne soit supprimé du cache.The Insert method enables you to insert a new item in the cache and provide a delegate that is called before the item is removed from the cache. Dans le délégué, vous pouvez mettre à jour l’élément mis en cache et ainsi empêcher sa suppression du cache.In the delegate, you can update the cached item and thereby prevent it from being removed from the cache.

Cette méthode remplacera un élément existant Cache par le même key paramètre.This method will overwrite an existing Cache item with the same key parameter.

Vous ne pouvez pas définir à la fois les absoluteExpiration slidingExpiration paramètres et.You cannot set both the absoluteExpiration and slidingExpiration parameters. Si vous voulez que l’élément de cache expire à un moment donné, vous affectez au absoluteExpiration paramètre l’heure spécifique et au slidingExpiration paramètre la valeur 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 vous voulez que l’élément de cache expire après un laps de temps défini depuis le dernier accès à l’élément, vous définissez le slidingExpiration paramètre sur l’intervalle d’expiration et vous affectez au paramètre la valeur absoluteExpiration NoAbsoluteExpiration .If you intend the cache item to expire after a set period of time since the item was last accessed, you set the slidingExpiration parameter to the expiration interval, and you set the absoluteExpiration parameter to NoAbsoluteExpiration.

Voir aussi

S’applique à

Produit Introduit

Insert(String, Object, CacheDependency)

Insère un objet dans le Cache qui présente des dépendances de fichier ou de clé.Inserts an object into the Cache that has file or key dependencies.

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)

Paramètres

key
String

Clé de cache utilisée pour identifier l'élément.The cache key used to identify the item.

value
Object

Objet à insérer dans le cache.The object to be inserted in the cache.

dependencies
CacheDependency

Dépendances de fichier ou de clé de cache pour l'objet inséré.The file or cache key dependencies for the inserted object. Lorsqu'une dépendance change, l'objet n'est plus valide et est supprimé du cache.When any dependency changes, the object becomes invalid and is removed from the cache. En l'absence de dépendances, ce paramètre contient null.If there are no dependencies, this parameter contains null.

Exceptions

Le paramètre key ou value est null.The key or value parameter is null.

Exemples

L’exemple suivant montre comment insérer un élément dans le cache d’une application avec une dépendance de cache sur un fichier de configuration XML.The following example demonstrates how to insert an item into an application's cache with a cache dependency on an XML configuration file.

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

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

Remarques

Cette méthode remplacera un élément de cache existant dont la clé correspond au key paramètre.This method will overwrite an existing cache item whose key matches the key parameter. L’objet ajouté au cache à l’aide de cette surcharge de la Insert méthode est inséré avec une priorité Default , une valeur d’expiration décalée de NoSlidingExpiration et une valeur d’expiration absolue de NoAbsoluteExpiration .The object added to the cache using this overload of the Insert method is inserted with a priority of Default, a sliding expiration value of NoSlidingExpiration, and an absolute expiration value of NoAbsoluteExpiration.

Voir aussi

S’applique à

Produit Introduit

Insert(String, Object)

Insère un élément dans l'objet Cache avec une clé de cache pour faire référence à son emplacement, en utilisant les valeurs par défaut fournies par l'énumération CacheItemPriority.Inserts an item into the Cache object with a cache key to reference its location, using default values provided by the CacheItemPriority enumeration.

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)

Paramètres

key
String

Clé de cache utilisée pour faire référence à l'élément.The cache key used to reference the item.

value
Object

Objet à insérer dans le cache.The object to be inserted into the cache.

Exceptions

Le paramètre key ou value est null.The key or value parameter is null.

Exemples

L’exemple suivant montre comment insérer un élément dans le cache d’une application.The following example demonstrates how to insert an item into an application's cache.

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

Remarques

Cette méthode remplacera un élément de cache existant dont la clé correspond au key paramètre.This method will overwrite an existing cache item whose key matches the key parameter. L’objet ajouté au cache à l’aide de cette surcharge de la Insert méthode est inséré sans dépendances de fichier ou de cache, une priorité de Default , une valeur d’expiration décalée de NoSlidingExpiration et une valeur d’expiration absolue de NoAbsoluteExpiration .The object added to the cache using this overload of the Insert method is inserted with no file or cache dependencies, a priority of Default, a sliding expiration value of NoSlidingExpiration, and an absolute expiration value of NoAbsoluteExpiration.

Voir aussi

S’applique à

Produit Introduit

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

Insère un objet dans le Cache avec des dépendances et des stratégies d'expiration.Inserts an object into the Cache with dependencies and expiration policies.

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)

Paramètres

key
String

Clé du cache utilisée pour faire référence à l'objet.The cache key used to reference the object.

value
Object

Objet à insérer dans le cache.The object to be inserted in the cache.

dependencies
CacheDependency

Dépendances de fichier ou de clé de cache pour l'objet inséré.The file or cache key dependencies for the inserted object. Lorsqu'une dépendance change, l'objet n'est plus valide et est supprimé du cache.When any dependency changes, the object becomes invalid and is removed from the cache. En l'absence de dépendances, ce paramètre contient null.If there are no dependencies, this parameter contains null.

absoluteExpiration
DateTime

Moment auquel l'objet inséré expire et est supprimé du cache.The time at which the inserted object expires and is removed from the cache. Pour éviter d'éventuels problèmes avec l'heure locale, par exemple lors des passages de l'heure d'hiver à l'heure d'été, utilisez UtcNow au lieu de Now pour cette valeur de paramètre.To avoid possible issues with local time such as changes from standard time to daylight saving time, use UtcNow rather than Now for this parameter value. Si vous utilisez l'expiration absolue, le paramètre slidingExpiration doit être NoSlidingExpiration.If you are using absolute expiration, the slidingExpiration parameter must be NoSlidingExpiration.

slidingExpiration
TimeSpan

L’intervalle entre l’heure du dernier accès de l’objet inséré et l’heure à laquelle cet objet expire.The interval between the time the inserted object is last accessed and the time at which that object expires. Si cette valeur est équivalente à 20 minutes, l’objet expire et est supprimé du cache 20 minutes après son dernier accès.If this value is the equivalent of 20 minutes, the object will expire and be removed from the cache 20 minutes after it was last accessed. Si vous utilisez l'expiration décalée, le paramètre absoluteExpiration doit être NoAbsoluteExpiration.If you are using sliding expiration, the absoluteExpiration parameter must be NoAbsoluteExpiration.

Exceptions

Le paramètre key ou value est null.The key or value parameter is null.

Vous avez affecté au paramètre slidingExpiration une valeur inférieure à TimeSpan.Zero, ou l'équivalent de plus d'une année.You set the slidingExpiration parameter to less than TimeSpan.Zero or the equivalent of more than one year.

Les paramètres absoluteExpiration et slidingExpiration sont tous deux définis pour l'élément que vous tentez d'ajouter au Cache.The absoluteExpiration and slidingExpiration parameters are both set for the item you are trying to add to the Cache.

Exemples

L’exemple suivant montre comment insérer un élément dans le cache d’une application avec une expiration absolue.The following example demonstrates how to insert an item into an application's cache with an absolute expiration.

Notes

Comme cette forme de la Insert méthode prend en charge les dépendances de cache, si l’élément n’a pas de dépendances, vous devez déclarer le dependency paramètre comme null ( Nothing dans Visual Basic) dans la liste de paramètres délimités par des virgules.Since this form of the Insert method supports cache dependencies, if the item has no dependencies, you must declare the dependency parameter as null (Nothing in Visual Basic) in the comma-delimited list of parameters.

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

L’exemple suivant montre comment insérer un élément dans le cache avec une expiration décalée.The following example demonstrates how to insert an item into the cache with a sliding expiration.

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

Remarques

Cette méthode remplacera un élément existant Cache par le même key paramètre.This method will overwrite an existing Cache item with the same key parameter.

Si le slidingExpiration paramètre a la valeur NoSlidingExpiration , l’expiration décalée est désactivée.If the slidingExpiration parameter is set to NoSlidingExpiration, sliding expiration is disabled. Si vous définissez le slidingExpiration paramètre sur une valeur supérieure à Zero , le absoluteExpiration paramètre a la Now valeur plus la valeur contenue dans le slidingExpiration paramètre.If you set the slidingExpiration parameter to greater than Zero, the absoluteExpiration parameter is set to Now plus the value contained in the slidingExpiration parameter. Si l’élément est demandé à partir du cache avant la durée spécifiée par le absoluteExpiration paramètre, l’élément est de nouveau placé dans le cache, et absoluteExpiration est à nouveau défini sur DateTime.Now plus la valeur contenue dans le slidingExpiration paramètre.If the item is requested from the cache before the amount of time specified by the absoluteExpiration parameter, the item will be placed in the cache again, and absoluteExpiration will again be set to DateTime.Now plus the value contained in the slidingExpiration parameter. Si l’élément n’est pas demandé à partir du cache avant la date dans le absoluteExpiration paramètre, l’élément est supprimé du cache.If the item is not requested from the cache before the date in the absoluteExpiration parameter, the item is removed from the cache. L’élément ajouté au cache à l’aide de cette surcharge de la méthode Insert est inséré avec une priorité de Default .The item added to the cache using this overload of the insert method is inserted with a priority of Default.

Voir aussi

S’applique à

Produit Introduit