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 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 |
| 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 -> 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é 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
Le paramètre key ou value est null.
Vous avez affecté au paramètre slidingExpiration une valeur inférieure à TimeSpan.Zero, ou l'équivalent de plus d'une année.
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 à une heure spécifique, vous définissez le absoluteExpiration paramètre sur l’heure spécifique et le paramètre sur slidingExpirationNoSlidingExpiration.
Si vous prévoyez que l’élément de cache expire après un certain laps de temps é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
S’applique à
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 -> 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é 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
Le paramètre key, value ou onUpdateCallback est null.
Vous avez affecté au paramètre slidingExpiration une valeur inférieure à TimeSpan.Zero, ou l'équivalent de plus d'une année.
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 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 absoluteExpiration paramètres et .slidingExpiration Si vous prévoyez 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 paramètre sur slidingExpirationNoSlidingExpiration.
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
S’applique à
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 -> 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 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
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é , Defaultune valeur d’expiration glissante de NoSlidingExpirationet une valeur d’expiration absolue de NoAbsoluteExpiration.
Voir aussi
S’applique à
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 -> unitPublic 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
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 dépendances de fichier ou de cache, une priorité de Default, une valeur d’expiration glissante de NoSlidingExpirationet une valeur d’expiration absolue de NoAbsoluteExpiration.
Voir aussi
S’applique à
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 -> unitPublic 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
Le paramètre key ou value est null.
Vous avez affecté au paramètre slidingExpiration une valeur inférieure à TimeSpan.Zero, ou l'équivalent de plus d'une année.
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 pas de dépendances, vous devez déclarer le dependency paramètre en tant que null (Nothing en Visual Basic) dans la liste de paramètres délimitées 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.
