Insertion de méthode
Insérer (chaîne, objet)
Insère un élément (objet) dans le cache.
Déclaration
CacheItemVersion Insert(string key, object value)
Paramètres
Type | Nom | Description |
---|---|---|
Système.String | key | Clé unique pour identifier l'élément de cache. |
Système.Object | Plus-value | L'élément (objet) qui doit être inséré dans le cache. |
Retours
Type | Description |
---|---|
CacheItemVersionCacheItemVersion | Représente la version de chaque élément du cache. |
Remarques
Si la clé existe déjà, cette surcharge écrase les valeurs de la clé existante ICache Objet. Si la clé n'existe pas, il ajoute l'élément au cache.
Exemples
L'exemple suivant montre comment insérer un élément (objet) dans le cache.
Cache cache = CacheManager.GetCache("demoClusteredCache");
Product product = new Product();
product.Id = 1;
product.Name = "Chai";
string key = "Product0";
cache.Insert(key,product);
Insérer (chaîne, élément de cache, poignée de verrouillage, booléen)
Insère un CacheItem dans le cache.
Déclaration
CacheItemVersion Insert(string key, CacheItem item, LockHandle lockHandle, bool releaseLock)
Paramètres
Type | Nom | Description |
---|---|---|
Système.String | key | Clé unique pour identifier l'élément de cache. |
CacheItem | questions d'examen | CacheItem à insérer dans le cache. |
Poignée de verrouillage | poignée de verrouillage | Une instance de Poignée de verrouillage qui contient les informations de verrouillage. Si l'élément est verrouillé, il ne peut être mis à jour que si le lockHandle correct est spécifié. |
Système.Booléen | relâcherLock | Un indicateur pour déterminer si le verrou doit être libéré ou non après l'exécution de l'opération. |
Retours
Type | Description |
---|---|
CacheItemVersionCacheItemVersion | Représente la version de chaque élément du cache. |
Remarques
Si la clé existe déjà, cette surcharge écrase les valeurs de la clé existante ICache Objet. Si la clé n'existe pas, il ajoute l'élément au cache. Si CacheItem contient des valeurs non valides, l'exception associée est levée. Voir CacheItem pour les valeurs de propriété non valides et les exceptions associées.
Exemples
L'exemple suivant montre comment insérer un élément dans le cache avec une expiration glissante de 5 minutes, une priorité de haut.
ICache cache = CacheManager.GetCache("demoClusteredCache");
Product product = new Product();
product.Id = 1;
product.Name = "Chai";
CacheItem item = new CacheItem(product);
item.Priority = CacheItemPriority.Low;
string key = "Product0";
cache.Add(key, item);
LockHandle lockHandle = new LockHandle();
CacheItem cachedItem = cache.Get<CacheItem>("cachedItemKey", true, new TimeSpan(0, 5, 0), ref lockHandle);
if (cachedItem != null)
{
try
{
cachedItem.Priority = CacheItemPriority.High;
cachedItem.Expiration = new Expiration(ExpirationType.Sliding, new TimeSpan(0, 2, 0));
cache.Insert(key, cachedItem, lockHandle, true);
}
catch (OperationFailedException ex)
{
...
}
}
Insérer (Chaîne, CacheItem, WriteThruOptions, LockHandle, Booléen)
Insère un CacheItem dans le cache, tout en permettant de spécifier les WriteThruOptions.
Déclaration
CacheItemVersion Insert(string key, CacheItem item, WriteThruOptions writeThruOptions = null, LockHandle lockHandle = null, bool releaseLock = false)
Paramètres
Type | Nom | Description |
---|---|---|
Système.String | key | Clé unique pour identifier le CacheItem. |
CacheItem | questions d'examen | CacheItem à insérer dans le cache. |
Options d'écriture | WriteThruOptions | Options d'écriture concernant la mise à jour de la source de données. Cela peut être WriteThru, WriteBehind ou aucun. |
Poignée de verrouillage | poignée de verrouillage | Une instance de Poignée de verrouillage qui contient les informations de verrouillage. Si l'élément est verrouillé, il ne peut être mis à jour que si le lockHandle correct est spécifié. |
Système.Booléen | relâcherLock | Un indicateur pour déterminer si le verrou doit être libéré ou non après l'exécution de l'opération. |
Retours
Type | Description |
---|---|
CacheItemVersionCacheItemVersion | Représente la version de chaque élément du cache. |
Remarques
Si la clé existe déjà, cette surcharge écrase les valeurs de la clé existante ICache article. Si la clé n'existe pas, il ajoute l'élément au cache. Si CacheItem contient des valeurs non valides, l'exception associée est levée. La fonctionnalité de lockhandle avec WriteThru n'est pas prise en charge. Voir CacheItem pour les valeurs de propriété non valides et les exceptions associées.
Exemples
L'exemple suivant montre comment insérer un élément dans le cache avec une expiration glissante de 5 minutes et une priorité élevée.
ICache cache = CacheManager.GetCache("demoClusteredCache");
Product product = new Product();
product.Id = 1;
product.Name = "Chai";
CacheItem item = new CacheItem(product);
item.Priority = CacheItemPriority.Low;
string key = "Product0";
cache.Add(key, item);
LockHandle lockHandle = new LockHandle();
CacheItem cachedItem = cache.Get<CacheItem>("cachedItemKey", true, new TimeSpan(0, 5, 0), ref lockHandle);
if (cachedItem != null)
{
try
{
cachedItem.Priority = CacheItemPriority.High;
cachedItem.Expiration = new Expiration(ExpirationType.Sliding, new TimeSpan(0, 2, 0));
WriteThruOptions writeThruOptions = new WriteThruOptions(WriteMode.WriteThru, "ProdDataSource1");
cache.Insert(key, cachedItem, writeThruOptions, lockHandle, true);
}
catch (OperationFailedException ex)
{
...
}
}