MemoryCache.Set Méthode

Définition

Espace de noms:

System.Runtime.Caching

Assembly:

System.Runtime.Caching.dll

Paquet:

System.Runtime.Caching v11.0.0-preview.4.26230.115

Insère une entrée de cache dans le cache.

Surcharges

Nom	Description
Set(CacheItem, CacheItemPolicy)	Insère une entrée de cache dans le cache à l’aide d’une CacheItem instance pour fournir la clé et la valeur de l’entrée de cache.
Set(String, Object, DateTimeOffset, String)	Insère une entrée de cache dans le cache à l’aide d’une clé et d’une valeur et spécifie les détails d’expiration basés sur le temps.
Set(String, Object, CacheItemPolicy, String)	Insère une entrée de cache dans le cache à l’aide d’une clé et d’une valeur et d’éviction.

Remarques

Si l’entrée spécifiée n’existe pas, elle est créée. Si l’entrée spécifiée existe, elle est mise à jour.

Set(CacheItem, CacheItemPolicy)

Source:

MemoryCache.cs

Insère une entrée de cache dans le cache à l’aide d’une CacheItem instance pour fournir la clé et la valeur de l’entrée de cache.

public:
 override void Set(System::Runtime::Caching::CacheItem ^ item, System::Runtime::Caching::CacheItemPolicy ^ policy);

public override void Set(System.Runtime.Caching.CacheItem item, System.Runtime.Caching.CacheItemPolicy policy);

override this.Set : System.Runtime.Caching.CacheItem * System.Runtime.Caching.CacheItemPolicy -> unit

Public Overrides Sub Set (item As CacheItem, policy As CacheItemPolicy)

Paramètres

item

CacheItem

Objet qui représente une entrée de cache à insérer.

policy

CacheItemPolicy

Objet qui contient des détails d’éviction pour l’entrée du cache. Cet objet fournit plus d’options d’éviction qu’une expiration absolue simple.

Exceptions

ArgumentNullException

item a la valeur null.

- ou -

La Key propriété est null.

- ou -

La Value propriété est null.

ArgumentException

Une combinaison non valide d’arguments pour l’entrée du cache a été passée. Cela se produit si les détails d’expiration suivants sont définis sur l’objet de stratégie pour l’entrée du cache :

• Si les valeurs d’expiration absolue et glissante de l’objet CacheItemPolicy sont définies sur des valeurs autres que les valeurs par défaut et InfiniteAbsoluteExpirationNoSlidingExpiration les champs. La MemoryCache classe ne peut pas définir la stratégie d’expiration en fonction d’une expiration absolue et d’une expiration glissante. Un seul paramètre d’expiration peut être défini explicitement lorsque vous utilisez la MemoryCache classe. L’autre paramètre doit être défini sur InfiniteAbsoluteExpiration ou NoSlidingExpiration propriété.

• Si le rappel de suppression et le rappel de mise à jour sont spécifiés pour CacheItemPolicy l’objet. La MemoryCache classe prend uniquement en charge l’utilisation d’un type de rappel par entrée de cache.

ArgumentOutOfRangeException

La SlidingExpiration propriété est définie sur une valeur inférieure à Zero.

- ou -

La SlidingExpiration propriété est définie sur une valeur supérieure à un an.

- ou -

Il Priority ne s’agit pas d’une valeur de l’énumération CacheItemPriority .

Remarques

Comme d’autres Set surcharges de méthode, la Set méthode place toujours une valeur de cache dans le cache, qu’une entrée existe déjà qui a la même clé. Si l’entrée spécifiée n’existe pas dans le cache, une nouvelle entrée de cache est insérée. Si l’entrée spécifiée existe déjà, sa valeur est mise à jour.

Set(String, Object, DateTimeOffset, String)

Source:

MemoryCache.cs

Insère une entrée de cache dans le cache à l’aide d’une clé et d’une valeur et spécifie les détails d’expiration basés sur le temps.

public override void Set(string key, object value, DateTimeOffset absoluteExpiration, string regionName = default);

override this.Set : string * obj * DateTimeOffset * string -> unit

Public Overrides Sub Set (key As String, value As Object, absoluteExpiration As DateTimeOffset, Optional regionName As String = Nothing)

Paramètres

key

String

Identificateur unique de l’entrée de cache à insérer.

value

Object

Données de l’entrée de cache.

absoluteExpiration

DateTimeOffset

Date et heure fixes auxquelles l’entrée du cache expire.

regionName

String

Région nommée dans le cache à laquelle une entrée de cache peut être ajoutée. Ne passez pas de valeur pour ce paramètre. Ce paramètre est null par défaut, car la MemoryCache classe n’implémente pas les régions.

Exceptions

NotSupportedException

regionName n’est pas null.

ArgumentNullException

key a la valeur null.

- ou -

value a la valeur null.

ArgumentException

• Une combinaison non valide d’arguments pour l’entrée du cache a été passée. Cela se produit si les détails d’expiration suivants sont définis sur l’objet de stratégie pour l’entrée du cache :

• Si les valeurs d’expiration absolue et glissante de l’objet CacheItemPolicy sont définies sur des valeurs autres que les valeurs par défaut et InfiniteAbsoluteExpirationNoSlidingExpiration. Cela se produit parce que la MemoryCache classe ne prend pas en charge les entrées arrivant à expiration en fonction d’une expiration absolue et d’une expiration glissante. Un seul paramètre d’expiration peut être défini explicitement lorsque vous utilisez la MemoryCache classe. L’autre paramètre doit être défini sur InfiniteAbsoluteExpiration ou NoSlidingExpiration.

• Si le rappel de suppression et le rappel de mise à jour sont spécifiés sur CacheItemPolicy l’objet. La MemoryCache classe prend uniquement en charge l’utilisation d’un type de rappel par entrée de cache.

ArgumentOutOfRangeException

La SlidingExpiration propriété est définie sur une valeur inférieure à Zero.

- ou -

La SlidingExpiration propriété est définie sur une valeur supérieure à un an.

- ou -

• La Priority propriété n’est pas une valeur de l’énumération CacheItemPriority .

Remarques

Comme d’autres Set surcharges de méthode, la Set méthode place toujours une valeur de cache dans le cache, que l’entrée existe déjà avec la même clé. Si l’entrée spécifiée n’existe pas, une nouvelle entrée de cache est insérée. Si l’entrée spécifiée existe, elle est mise à jour.

Le absoluteExpiration paramètre indique quand l’entrée doit être supprimée du cache.

La suppression d’une entrée déclenche tous les moniteurs de modification associés. Si l’élément supprimé a été associé à un objet ou à un CacheItemUpdateCallback objet, la raison de la suppression transmise aux rappels est contenue dans la CacheItemRemovedCallback propriété.Removed

Set(String, Object, CacheItemPolicy, String)

Source:

MemoryCache.cs

Insère une entrée de cache dans le cache à l’aide d’une clé et d’une valeur et d’éviction.

public override void Set(string key, object value, System.Runtime.Caching.CacheItemPolicy policy, string regionName = default);

override this.Set : string * obj * System.Runtime.Caching.CacheItemPolicy * string -> unit

Public Overrides Sub Set (key As String, value As Object, policy As CacheItemPolicy, Optional regionName As String = Nothing)

Paramètres

key

String

Identificateur unique de l’entrée de cache à insérer.

value

Object

Données de l’entrée de cache.

policy

CacheItemPolicy

Objet qui contient des détails d’éviction pour l’entrée du cache. Cet objet fournit plus d’options d’éviction qu’une expiration absolue simple.

regionName

String

Région nommée dans le cache à laquelle une entrée de cache peut être ajoutée. Ne passez pas de valeur pour ce paramètre. Ce paramètre est null par défaut, car la MemoryCache classe n’implémente pas les régions.

Exceptions

ArgumentNullException

key a la valeur null.

- ou -

value est null

- ou -

La référence de rappel transmise à la méthode d’assistance dans la UpdateCallback propriété est null.

ArgumentException

• Une combinaison d’arguments non valide pour l’entrée de cache existe. Cela se produit si les détails d’expiration suivants sont définis sur l’objet de stratégie pour l’entrée du cache :

• Si les valeurs d’expiration absolue et glissante de l’objet CacheItemPolicy sont définies sur des valeurs autres que les valeurs par défaut et InfiniteAbsoluteExpirationNoSlidingExpiration. Cela est dû au fait que la MemoryCache classe ne prend pas en charge les entrées arrivant à expiration en fonction d’une expiration absolue et d’une expiration glissante. Un seul paramètre d’expiration peut être défini explicitement lorsque vous utilisez la MemoryCache classe. L’autre paramètre doit être défini sur InfiniteAbsoluteExpiration ou NoSlidingExpiration.

• Si le rappel de suppression et le rappel de mise à jour sont spécifiés sur CacheItemPolicy la classe. La MemoryCache classe prend uniquement en charge l’utilisation d’un type de rappel par entrée de cache.

ArgumentOutOfRangeException

La SlidingExpiration propriété est définie sur une valeur inférieure à Zero.

- ou -

La SlidingExpiration propriété est définie sur une valeur supérieure à un an.

- ou -

La Priority propriété n’est pas une valeur de l’énumération CacheItemPriority .

NotSupportedException

regionName n’est pas null.

Remarques

Comme d’autres Set surcharges de méthode, la Set méthode place toujours une valeur de cache dans le cache, que l’entrée correspondante existe déjà. Si l’entrée spécifiée n’existe pas dans le cache, une nouvelle entrée de cache est insérée. Si l’entrée spécifiée existe, elle est mise à jour.

La suppression d’une entrée déclenche tous les moniteurs de modification associés. Si l’élément supprimé a été associé à un objet ou à un CacheItemUpdateCallback objet, la raison de la suppression transmise aux rappels est contenue dans la CacheItemRemovedCallback propriété.Removed