Cache.Insert Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Insère un élément dans l’objet Cache . Utilisez l’une des versions de cette méthode pour remplacer un élément existant Cache avec le même key paramètre.
Surcharges
| Nom | Description |
|---|---|
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback) |
Insère un objet dans l’objet Cache avec des dépendances, des stratégies d’expiration et de priorité, et un délégué que vous pouvez utiliser pour notifier votre application lorsque l’élément inséré est supprimé du |
| Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback) |
Insère un objet dans l’objet Cache avec des dépendances, des stratégies d’expiration et un délégué que vous pouvez utiliser pour notifier l’application avant la suppression de l’élément du cache. |
| Insert(String, Object, CacheDependency) |
Insère un objet dans le Cache fichier ou les dépendances de clé. |
| Insert(String, Object) |
Insère un élément dans l’objet avec une clé de Cache cache pour référencer 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 les Cache stratégies d’expiration et de dépendances. |
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemPriority, CacheItemRemovedCallback)
Insère un objet dans l’objet Cache avec des dépendances, des stratégies d’expiration et de priorité, et un délégué que vous pouvez utiliser pour notifier 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 -> unitPublic 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é de cache utilisée pour référencer l’objet.
- value
- Object
Objet à insérer dans le cache.
- dependencies
- CacheDependency
Dépendances de clé de fichier ou de cache pour l’élément. Lorsqu’une dépendance change, l’objet devient non valide et est supprimé du cache. S’il n’existe aucune dépendance, ce paramètre contient null.
- absoluteExpiration
- DateTime
Heure à laquelle l’objet inséré expire et est supprimé du cache. Pour éviter les problèmes possibles liés à l’heure locale, tels que les modifications de l’heure standard à l’heure d’été, utilisez UtcNow plutôt que Now pour cette valeur de paramètre. Si vous utilisez l’expiration absolue, le slidingExpiration paramètre doit être NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Intervalle entre le moment où l’objet inséré a été accédé pour la dernière fois et l’heure à laquelle cet objet expire. Si cette valeur équivaut à 20 minutes, l’objet expire et est supprimé du cache 20 minutes après son dernier accès. Si vous utilisez l’expiration glissante, le absoluteExpiration paramètre doit être NoAbsoluteExpiration.
- priority
- CacheItemPriority
Coût de l’objet par rapport à d’autres éléments stockés dans le cache, tel qu’exprimé par l’énumération CacheItemPriority . Cette valeur est utilisée par le cache lorsqu’il supprime des objets ; les objets dont le coût est inférieur sont supprimés du cache avant les objets dont le coût est plus élevé.
- onRemoveCallback
- CacheItemRemovedCallback
Délégué qui, s’il est fourni, sera appelé lorsqu’un objet est supprimé du cache. Vous pouvez l’utiliser pour notifier les applications quand leurs objets sont supprimés du cache.
Exceptions
Le ou key le value paramètre est null.
Vous définissez le slidingExpiration paramètre sur inférieur TimeSpan.Zero ou équivalent de plus d’un an.
Les absoluteExpiration paramètres sont slidingExpiration tous deux définis pour l’élément que vous essayez d’ajouter à l’élément 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.
Note
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 paramètres et absoluteExpiration les slidingExpiration paramètres. Si vous envisagez que l’élément de cache expire à une heure spécifique, vous définissez le absoluteExpiration paramètre sur l’heure spécifique et le slidingExpiration paramètre NoSlidingExpirationsur .
Si vous prévoyez que l’élément de cache expire après une certaine durée écoulée depuis le dernier accès à l’élément, vous définissez le paramètre sur l’intervalle slidingExpiration d’expiration et le absoluteExpiration paramètre NoAbsoluteExpirationsur .
Voir aussi
- DateTime
- TimeSpan
- CacheItemPriority
- CacheItemRemovedCallback
- Mise en cache des données d’application
S’applique à
Insert(String, Object, CacheDependency, DateTime, TimeSpan, CacheItemUpdateCallback)
Insère un objet dans l’objet Cache avec des dépendances, des stratégies d’expiration et un délégué que vous pouvez utiliser pour notifier l’application avant la suppression de l’élément 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 -> unitPublic 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é de cache utilisée pour référencer l’objet.
- value
- Object
Objet à insérer dans le cache.
- dependencies
- CacheDependency
Dépendances de clé de fichier ou de cache pour l’élément. Lorsqu’une dépendance change, l’objet devient non valide et est supprimé du cache. S’il n’existe aucune dépendance, ce paramètre contient null.
- absoluteExpiration
- DateTime
Heure à laquelle l’objet inséré expire et est supprimé du cache. Pour éviter les problèmes éventuels liés à l’heure locale, tels que les modifications de l’heure standard à l’heure d’été, utilisez UtcNow plutôt que pour cette valeur de Now paramètre. Si vous utilisez l’expiration absolue, le slidingExpiration paramètre doit être défini sur NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Intervalle entre l’heure à laquelle l’objet mis en cache a été accédé pour la dernière fois et l’heure à laquelle cet objet expire. Si cette valeur équivaut à 20 minutes, l’objet expire et est supprimé du cache 20 minutes après son dernier accès. Si vous utilisez l’expiration glissante, le absoluteExpiration paramètre doit être défini sur NoAbsoluteExpiration.
- onUpdateCallback
- CacheItemUpdateCallback
Délégué qui sera appelé avant la suppression de l’objet du cache. Vous pouvez l’utiliser pour mettre à jour l’élément mis en cache et vous assurer qu’il n’est pas supprimé du cache.
Exceptions
Le , keyou value le onUpdateCallbackparamètre est null.
Vous définissez le slidingExpiration paramètre sur inférieur TimeSpan.Zero ou équivalent de plus d’un an.
Les absoluteExpiration paramètres sont slidingExpiration tous deux définis pour l’élément que vous essayez d’ajouter à l’élément Cache.
- ou -
Le dependencies paramètre est null, et le absoluteExpiration paramètre est défini NoAbsoluteExpirationsur , et le slidingExpiration paramètre est défini sur 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 la suppression de l’élément du cache. Dans le délégué, vous pouvez mettre à jour l’élément mis en cache et ainsi l’empêcher d’être supprimé 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 paramètres et absoluteExpiration les slidingExpiration paramètres. Si vous envisagez que l’élément de cache expire à une heure spécifique, vous définissez le absoluteExpiration paramètre sur l’heure spécifique et le slidingExpiration paramètre NoSlidingExpirationsur .
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 paramètre sur l’intervalle slidingExpiration d’expiration et définissez le paramètre absoluteExpirationsur NoAbsoluteExpiration .
Voir aussi
S’applique à
Insert(String, Object, CacheDependency)
Insère un objet dans le Cache fichier ou les dépendances 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 -> unitPublic 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 clé de fichier ou de cache pour l’objet inséré. Lorsqu’une dépendance change, l’objet devient non valide et est supprimé du cache. S’il n’existe aucune dépendance, ce paramètre contient null.
Exceptions
Le ou key le value paramètre 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 et NoSlidingExpirationune valeur d’expiration absolue de NoAbsoluteExpiration.
Voir aussi
S’applique à
Insert(String, Object)
Insère un élément dans l’objet avec une clé de Cache cache pour référencer 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 -> unitPublic Sub Insert (key As String, value As Object)Paramètres
- key
- String
Clé de cache utilisée pour référencer l’élément.
- value
- Object
Objet à insérer dans le cache.
Exceptions
Le ou key le value paramètre 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 dépendances de fichier ou de cache, une priorité de Default, une valeur d’expiration glissante et NoSlidingExpirationune valeur d’expiration absolue de NoAbsoluteExpiration.
Voir aussi
S’applique à
Insert(String, Object, CacheDependency, DateTime, TimeSpan)
Insère un objet dans les Cache stratégies d’expiration et de dépendances.
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)Paramètres
- key
- String
Clé de cache utilisée pour référencer l’objet.
- value
- Object
Objet à insérer dans le cache.
- dependencies
- CacheDependency
Dépendances de clé de fichier ou de cache pour l’objet inséré. Lorsqu’une dépendance change, l’objet devient non valide et est supprimé du cache. S’il n’existe aucune dépendance, ce paramètre contient null.
- absoluteExpiration
- DateTime
Heure à laquelle l’objet inséré expire et est supprimé du cache. Pour éviter les problèmes possibles liés à l’heure locale, tels que les modifications de l’heure standard à l’heure d’été, utilisez UtcNow plutôt que Now pour cette valeur de paramètre. Si vous utilisez l’expiration absolue, le slidingExpiration paramètre doit être NoSlidingExpiration.
- slidingExpiration
- TimeSpan
Intervalle entre le dernier accès à l’objet inséré et l’heure à laquelle cet objet expire. Si cette valeur équivaut à 20 minutes, l’objet expire et est supprimé du cache 20 minutes après son dernier accès. Si vous utilisez l’expiration glissante, le absoluteExpiration paramètre doit être NoAbsoluteExpiration.
Exceptions
Le ou key le value paramètre est null.
Vous définissez le slidingExpiration paramètre sur inférieur TimeSpan.Zero ou équivalent de plus d’un an.
Les absoluteExpiration paramètres sont slidingExpiration tous deux définis pour l’élément que vous essayez d’ajouter à l’élément Cache.
Exemples
L’exemple suivant montre comment insérer un élément dans le cache d’une application avec une expiration absolue.
Note
Étant donné que cette forme de la méthode Insert prend en charge les dépendances de cache, si l’élément n’a pas de dépendances, vous devez déclarer le paramètre dependency comme null (Nothing dans Visual Basic) dans la liste délimitée par des virgules des paramètres.
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 slidingExpiration paramètre est défini sur 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é à partir du cache avant la durée spécifiée par le absoluteExpiration paramètre, l’élément sera de nouveau placé dans le cache et absoluteExpiration sera de 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 du 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.
