Cache.Insert Méthode

Définition

Espace de noms:

System.Web.Caching

Assembly:

System.Web.dll

Insère un élément dans l'objet Cache. Utilisez l'une des versions de cette méthode pour remplacer un élément Cache existant par le même paramètre key.

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.
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.
Insert(String, Object, CacheDependency)	Insère un objet dans le Cache qui présente des dépendances de fichier ou de clé.
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.
Insert(String, Object, CacheDependency, DateTime, TimeSpan)	Insère un objet dans le Cache avec des dépendances et des stratégies d'expiration.

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.

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.

value

Object

Objet à insérer dans le cache.

dependencies

CacheDependency

Dépendances de fichier ou de clé de cache pour l'élément considéré. Lorsqu'une dépendance change, l'objet n'est plus valide et est supprimé du cache. En l'absence de dépendances, ce paramètre contient null.

absoluteExpiration

DateTime

Moment auquel l'objet inséré expire et est supprimé du 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. Si vous utilisez l'expiration absolue, le paramètre slidingExpiration doit être NoSlidingExpiration.

slidingExpiration

TimeSpan

Intervalle entre le dernier accès à l'objet inséré et le moment où cet objet expire. Si cette valeur est équivalente à 20 minutes, l’objet expire et est supprimé du cache 20 minutes après son dernier accès. Si vous utilisez l'expiration décalée, le paramètre absoluteExpiration doit être 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. 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.

onRemoveCallback

CacheItemRemovedCallback

Délégué qui, s'il est fourni, est appelé lorsqu'un objet est supprimé du cache. Vous pouvez l'utiliser pour notifier aux applications que leurs objets sont supprimés du cache.

Exceptions

ArgumentNullException

Le paramètre key ou value est null.

ArgumentOutOfRangeException

Vous avez affecté au paramètre slidingExpiration une valeur inférieure à TimeSpan.Zero, ou l'équivalent de plus d'une année.

ArgumentException

Les paramètres absoluteExpiration et slidingExpiration sont tous deux définis pour l'élément que vous tentez d'ajouter au Cache.

Exemples

L’exemple suivant montre comment attribuer une priorité élevée à un élément lorsque vous l’insérez dans l’objet de Cache votre application.

Notes

Pour plus d’informations sur l’utilisation de cette méthode avec le CacheItemRemovedCallback délégué, consultez Guide pratique pour notifier une application lorsqu’un élément est supprimé du 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 remplace un élément existant Cache avec le même key paramètre.

Vous ne pouvez pas définir les absoluteExpiration paramètres et .slidingExpiration Si vous prévoyez que l’élément de cache expire à un moment spécifique, vous définissez le absoluteExpiration paramètre sur l’heure spécifique et le slidingExpiration paramètre sur NoSlidingExpiration.

Si vous prévoyez que l’élément de cache expire une fois qu’un certain délai s’est écoulé depuis le dernier accès à l’élément, vous définissez le slidingExpiration paramètre sur l’intervalle d’expiration et le absoluteExpiration paramètre sur NoAbsoluteExpiration.

Voir aussi

• DateTime
• TimeSpan
• CacheItemPriority
• CacheItemRemovedCallback
• Mise en cache des données d’application

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.

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.

value

Object

Objet à insérer dans le cache.

dependencies

CacheDependency

Dépendances de fichier ou de clé de cache pour l'élément considéré. Lorsqu'une dépendance change, l'objet n'est plus valide et est supprimé du cache. En l'absence de dépendances, ce paramètre contient null.

absoluteExpiration

DateTime

Moment auquel l'objet inséré expire et est supprimé du 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. Si vous utilisez l'expiration absolue, le paramètre slidingExpiration doit avoir la valeur NoSlidingExpiration.

slidingExpiration

TimeSpan

Intervalle entre l'heure du dernier accès à l'objet en cache et le moment où cet objet expire. Si cette valeur est équivalente à 20 minutes, l’objet expire et est supprimé du cache 20 minutes après son dernier accès. Si vous utilisez l'expiration décalée, le paramètre absoluteExpiration doit avoir la valeur NoAbsoluteExpiration.

onUpdateCallback

CacheItemUpdateCallback

Délégué qui est appelé avant qu'un objet ne soit supprimé du cache. Vous pouvez l'utiliser pour mettre à jour l'élément en cache et vous assurer qu'il ne soit pas supprimé du cache.

Exceptions

ArgumentNullException

Le paramètre key, value ou onUpdateCallback est null.

ArgumentOutOfRangeException

Vous avez affecté au paramètre slidingExpiration une valeur inférieure à TimeSpan.Zero, ou l'équivalent de plus d'une année.

ArgumentException

Les paramètres absoluteExpiration et slidingExpiration sont tous deux définis pour l'élément que vous tentez d'ajouter au Cache.

- ou -

Le paramètre dependencies est null, le paramètre absoluteExpiration a la valeur NoAbsoluteExpiration, et le paramètre slidingExpiration a la valeur 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é appelé avant que l’élément ne soit supprimé du cache. Dans le délégué, vous pouvez mettre à jour l’élément mis en cache et ainsi empêcher sa suppression du cache.

Cette méthode remplace un élément existant Cache avec le même key paramètre.

Vous ne pouvez pas définir les absoluteExpiration paramètres et .slidingExpiration Si vous prévoyez que l’élément de cache expire à un moment spécifique, vous définissez le absoluteExpiration paramètre sur l’heure spécifique et le slidingExpiration paramètre sur NoSlidingExpiration.

Si vous prévoyez que l’élément de cache expire après une période définie depuis le dernier accès à l’élément, vous définissez le slidingExpiration paramètre sur l’intervalle d’expiration et vous définissez le absoluteExpiration paramètre sur NoAbsoluteExpiration.

Voir aussi

• CacheItemUpdateCallback

Insert(String, Object, CacheDependency)

Insère un objet dans le Cache qui présente des dépendances de fichier ou de clé.

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.

value

Object

Objet à insérer dans le cache.

dependencies

CacheDependency

Dépendances de fichier ou de clé de cache pour l'objet inséré. Lorsqu'une dépendance change, l'objet n'est plus valide et est supprimé du cache. En l'absence de dépendances, ce paramètre contient null.

Exceptions

ArgumentNullException

Le paramètre key ou value est 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.

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

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

Remarques

Cette méthode remplace un élément de cache existant dont la clé correspond au key paramètre. L’objet ajouté au cache à l’aide de cette surcharge de la Insert méthode est inséré avec une priorité de Default, une valeur d’expiration glissante de NoSlidingExpirationet une valeur d’expiration absolue de NoAbsoluteExpiration.

Voir aussi

• CacheDependency

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.

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.

value

Object

Objet à insérer dans le cache.

Exceptions

ArgumentNullException

Le paramètre key ou value est null.

Exemples

L’exemple suivant montre comment insérer un élément dans le cache d’une application.

Cache.Insert("DSN", connectionString);

Cache.Insert("DSN", connectionString)

Remarques

Cette méthode remplace un élément de cache existant dont la clé correspond au key paramètre. L’objet ajouté au cache à l’aide de cette surcharge de la Insert méthode est inséré sans aucune dépendance de fichier ou de cache, une priorité de Default, une valeur d’expiration glissante de NoSlidingExpiration, et une valeur d’expiration absolue de NoAbsoluteExpiration.

Voir aussi

• Mise en cache des données d’application

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

Insère un objet dans le Cache avec des dépendances et des stratégies d'expiration.

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.

value

Object

Objet à insérer dans le cache.

dependencies

CacheDependency

Dépendances de fichier ou de clé de cache pour l'objet inséré. Lorsqu'une dépendance change, l'objet n'est plus valide et est supprimé du cache. En l'absence de dépendances, ce paramètre contient null.

absoluteExpiration

DateTime

Moment auquel l'objet inséré expire et est supprimé du 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. Si vous utilisez l'expiration absolue, le paramètre slidingExpiration doit être NoSlidingExpiration.

slidingExpiration

TimeSpan

L’intervalle entre l’heure du dernier accès de l’objet inséré et l’heure à laquelle cet objet expire. Si cette valeur est équivalente à 20 minutes, l’objet expire et est supprimé du cache 20 minutes après son dernier accès. Si vous utilisez l'expiration décalée, le paramètre absoluteExpiration doit être NoAbsoluteExpiration.

Exceptions

ArgumentNullException

Le paramètre key ou value est null.

ArgumentOutOfRangeException

Vous avez affecté au paramètre slidingExpiration une valeur inférieure à TimeSpan.Zero, ou l'équivalent de plus d'une année.

ArgumentException

Les paramètres absoluteExpiration et slidingExpiration sont tous deux définis pour l'élément que vous tentez d'ajouter au Cache.

Exemples

L’exemple suivant montre comment insérer un élément dans le cache d’une application avec une expiration absolue.

Notes

Étant donné que cette forme de la Insert méthode prend en charge les dépendances de cache, si l’élément n’a aucune dépendance, vous devez déclarer le dependency paramètre comme null (Nothing en Visual Basic) dans la liste de paramètres délimitée par des virgules.

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

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

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

Remarques

Cette méthode remplace un élément existant Cache avec le même key paramètre.

Si le paramètre a la slidingExpiration valeur NoSlidingExpiration, l’expiration glissante est désactivée. Si vous définissez le slidingExpiration paramètre sur supérieur Zeroà , le absoluteExpiration paramètre est défini sur Now plus la valeur contenue dans le slidingExpiration paramètre. Si l’élément est demandé dans le cache avant la durée spécifiée par le absoluteExpiration paramètre, l’élément sera à nouveau placé dans le cache et absoluteExpiration sera à nouveau défini sur DateTime.Now plus la valeur contenue dans le slidingExpiration paramètre. Si l’élément n’est pas demandé dans le cache avant la date dans le absoluteExpiration paramètre, l’élément est supprimé du 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.

Voir aussi

• DateTime
• TimeSpan
• Mise en cache des données d’application