Classe CacheItem
NCache utilise une structure « clé » et « valeur » pour stocker les objets dans le cache. Lorsqu'un objet est ajouté au cache, il est stocké en tant que valeur et métadonnées par rapport à la clé spécifiée. Cette combinaison de valeur et de métadonnées est définie comme CacheItem dans NCache. La valeur des objets stockés dans le cache peut aller de simples types de chaînes à des objets complexes.
Classe CacheItem dans NCache possède des propriétés qui vous permettent de définir les métadonnées de l'élément à ajouter dans le cache de manière organisée. Dans les scénarios où plusieurs attributs doivent être définis lors de l’ajout d’un élément dans le cache, l’utilisation de CacheItem est préférable. L'utilisation de l'objet de classe CacheItem supprime le problème de l'utilisation de plusieurs surcharges d'API lors de l'ajout/mise à jour de données dans le cache. Vous pouvez facilement utiliser la surcharge de l'API de base et ajouter/mettre à jour des données facilement à l'aide de CacheItem.
Droit des successions
Assemblée: Alachisoft.NCache.Client.dll
Syntaxe
public class CacheItem : ICloneable
Exemples
L'exemple suivant montre comment créer une instance de la classe CacheItem et l'ajouter au ICache.
ICache cache = CacheManager.GetCache("demoCache");
Product product = new Product();
CacheItem item = new CacheItem(product);
item.Expiration = new Expiration(ExpirationType.Sliding, TimeSpan.FromMinutes(5));
item.Priority = CacheItemPriority.High;
cache.Add("productKey", item);
Constructeurs
Nom | Description |
---|---|
CacheItem(Objet) | Initialiser la nouvelle instance de l'élément de cache. |
biens
Nom | Description |
---|---|
CreationTime | Spécifie quand l'élément a été ajouté au cache pour la première fois. |
Dépendance | Dépendances de fichier ou de clé de cache pour l'élément. Lorsqu'une dépendance change, l'objet devient invalide et est supprimé du cache. S'il n'y a pas de dépendances, cette propriété contient une référence nulle. |
Expiration | Cette propriété définit Expiration pour l'élément de cache. Après le délai spécifié,
l'élément expire du cache.
|
Réservation de groupe | Les groupes vous aident à créer une partition logique de vos données mises en cache pour une récupération facile. Les informations de groupe peuvent être ajoutées à un élément en définissant la propriété Group de CacheItem. Cela réduit la complication liée à l'utilisation de surcharges d'API pour l'ajout de groupes au moment de l'ajout de groupes. ajout/mise à jour d'un élément dans le cache. |
DernièreModificationHeure | Cette propriété de CacheItem stocke l'heure de la dernière modification de l'élément de cache. Si un élément est mis à jour dans le cache, son heure de dernière modification est également mise à jour. L'heure de la dernière modification est vérifiée lorsque l'éviction basée sur la dernière utilisation est déclenchée. |
Balises nommées | Avec les balises nommées, l'utilisateur est en mesure de stocker des informations supplémentaires (de tout type) nécessaires à interroger l'objet stocké sous forme de chaîne. Les utilisateurs doivent fournir la liste des balises nommées, chacun ayant deux paramètres, "key" (nom d'une balise) comme chaîne et "value" (valeur assignée) comme tout type primitif. NCache vous permet ensuite de rechercher vos objets à travers ces balises nommées. Des balises nommées peuvent être spécifiées à l'aide de cette propriété de CacheItem. |
Priorité | Lorsque le cache de l'application est plein ou manque de mémoire, le cache est purgé de manière sélective. éléments pour libérer de la mémoire système. Lorsqu'un élément est ajouté au Cache, vous pouvez lui attribuer une priorité relative par rapport aux autres éléments stockés dans le cache utilisant cette propriété. Cela élimine le problème de l'utilisation de surcharges d'API pour définir la priorité. Éléments attribués plus haut les valeurs de priorité sont moins susceptibles d'être supprimées du cache lorsque le serveur traite un volume volumineux. nombre de requêtes, tandis que les éléments auxquels sont attribuées des valeurs de priorité inférieures sont plus susceptibles d'être supprimés. |
Options de resynchronisation | Cette propriété est utilisée pour définir la Options de resynchronisation pour l'élément de cache. |
DépendanceSync | Synchronise deux caches distincts afin qu'un élément mis à jour ou supprimé d'un cache puisse avoir le même effet sur le cache synchronisé. Pour la dépendance de synchronisation du cache, un élément doit exister dans le cache avant qu'un autre élément puisse être ajouté avec une dépendance à ce sujet. Cette propriété vous permet de définir la dépendance de synchronisation du cache avec un élément de cache. |
Tags | À l'aide de balises, vous pouvez associer des mots-clés à vos éléments de cache. Vous pouvez marquer vos données avec des balises, qui servent d'identifiants pour vos éléments de cache. Grâce à cette propriété, vous pouvez facilement définir des balises pour un élément de cache. |
Version | NCache utilise la gestion des versions des éléments du cache. CacheItemVersionCacheItemVersion est une propriété associée à chaque élément du cache. Il s'agit essentiellement d'une valeur numérique utilisée pour représenter la version de l'élément mis en cache qui change à chaque mise à jour d'un élément. Cette propriété vous permet de savoir si un changement s'est produit ou non dans un élément. Lorsque vous récupérez un élément du cache, vous récupérez également sa version actuelle du cache. |
Méthodologie
Nom | Description |
---|---|
Cloner() | Crée une copie superficielle de l'élément de cache. |
ObtenirValeur () | Renvoie la valeur stockée dans CacheItem. |
SetCacheDataNotification (CacheDataNotificationCallback, EventType, EventDataFilter) | Vous pouvez l'utiliser pour avertir les applications lorsque leurs objets sont mis à jour ou supprimés du cache. Les rappels peuvent être enregistrés contre Type d'événement pour la clé dans laquelle les éléments sont insérés. Les rappels sont annulés pour le même Type d'événement, si on l'appelle à nouveau. CacheDataNotificationCallback définit le rappel à utiliser pour les notifications. EventType décrit le type d'événement que vous souhaitez enregistrer. Si cet événement est déclenché, une notification sera reçue. |
DéfinirValeur(Objet) | Définit la valeur de l'élément de cache. |