Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
Cache, classe
Implémente le cache pour une application Web. Cette classe ne peut pas être héritée.
Assembly : System.Web (dans System.Web.dll)
Le type Cache expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
Count | Obtient le nombre d'éléments stockés dans le cache. |
|
|
EffectivePercentagePhysicalMemoryLimit | Obtient le pourcentage de mémoire physique qui peut être consommée par une application avant que 'ASP.NET commence à supprimer des éléments du cache. |
|
|
EffectivePrivateBytesLimit | Obtient le nombre d'octets disponibles pour le cache. |
|
|
Item | Obtient ou définit l'élément du cache correspondant à la clé spécifiée. |
| Nom | Description | |
|---|---|---|
|
Add | Ajoute l'élément spécifié à l'objet 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. |
|
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
|
Get | Récupère l'élément spécifié de l'objet Cache. |
|
|
GetEnumerator | Récupère un énumérateur de dictionnaire utilisé pour itérer au sein des paramètres de clé et leurs valeurs contenues dans le cache. |
|
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
|
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) | Insère un objet dans le Cache qui présente des dépendances de fichier ou de clé. |
|
|
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, 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, 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. |
|
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
|
Remove | Supprime l'élément spécifié dans l'objet Cache de l'application. |
|
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
| Nom | Description | |
|---|---|---|
|
AsParallel | Active la parallélisation d'une requête. (Défini par ParallelEnumerable.) |
|
|
AsQueryable | Convertit un IEnumerable en IQueryable. (Défini par Queryable.) |
|
|
Cast<TResult> | Convertit les éléments d'un IEnumerable vers le type spécifié. (Défini par Enumerable.) |
|
|
OfType<TResult> | Filtre les éléments d'un IEnumerable en fonction du type spécifié. (Défini par Enumerable.) |
| Nom | Description | |
|---|---|---|
|
NoAbsoluteExpiration | Utilisé dans le paramètre absoluteExpiration d'un appel de méthode Insert pour indiquer que l'élément ne doit jamais expirer. Ce champ est en lecture seule. |
|
|
NoSlidingExpiration | Utilisé comme paramètre slidingExpiration dans un appel à la méthode Insert ou Add pour désactiver les expirations décalées. Ce champ est en lecture seule. |
| Nom | Description | |
|---|---|---|
|
IEnumerable.GetEnumerator | Retourne un énumérateur qui peut itérer au sein de la collection d'objets Cache. |
Une instance de cette classe est créée par domaine d'application et elle demeure valide tant que le domaine d'application reste actif. Les informations sur une instance de cette classe sont disponibles via la propriété Cache de l'objet HttpContext ou de la propriété Cache de l'objet Page.
Remarque
|
|---|
|
La classe Cache n'est pas destinée à être utilisée en dehors des applications ASP.NET. Elle a été conçue et testée pour être utilisée dans ASP.NET afin de fournir une mise en cache aux applications Web. Pour les autres types d'applications, tels que les applications console ou les applications Windows Forms, utilisez la classe ObjectCache. |
L'exemple suivant est une page qui indique aux utilisateurs la valeur assignée à un élément du cache, puis les avertit lorsque l'élément est supprimé du cache. Il crée une méthode RemovedCallback qui comporte la signature du délégué CacheItemRemovedCallback pour avertir les utilisateurs lorsque l'élément de cache est supprimé et il utilise l'énumération CacheItemRemovedReason pour leur expliquer les raisons de la suppression. De plus, il utilise la propriété Cache.Item pour ajouter des objets au cache et récupérer la valeur de ces objets. Dans la méthode AddItemToCache, il utilise la méthode Cache.Add pour ajouter un élément au cache. Pour utiliser le délégué CacheItemRemovedCallback, vous devez ajouter un élément au cache en suivant cette méthode ou la méthode Cache.Insert afin que cet ASP.NET puisse faire automatiquement les appels de méthode corrects lorsque l'élément est supprimé. La méthode personnalisée RemoveItemFromCache utilise la méthode Cache.Remove pour supprimer explicitement l'élément du cache, de telle sorte que la méthode RemovedCallback est appelée.
<html> <Script runat=server language="C#"> static bool itemRemoved = false; static CacheItemRemovedReason reason; CacheItemRemovedCallback onRemove = null; public void RemovedCallback(String k, Object v, CacheItemRemovedReason r){ itemRemoved = true; reason = r; } public void AddItemToCache(Object sender, EventArgs e) { itemRemoved = false; onRemove = new CacheItemRemovedCallback(this.RemovedCallback); if (Cache["Key1"] == null) Cache.Add("Key1", "Value 1", null, DateTime.Now.AddSeconds(60), Cache.NoSlidingExpiration, CacheItemPriority.High, onRemove); } public void RemoveItemFromCache(Object sender, EventArgs e) { if(Cache["Key1"] != null) Cache.Remove("Key1"); } </Script> <body> <Form runat="server"> <input type=submit OnServerClick="AddItemToCache" value="Add Item To Cache" runat="server"/> <input type=submit OnServerClick="RemoveItemFromCache" value="Remove Item From Cache" runat="server"/> </Form> <% if (itemRemoved) { Response.Write("RemovedCallback event raised."); Response.Write("<BR>"); Response.Write("Reason: <B>" + reason.ToString() + "</B>"); } else { Response.Write("Value of cache key: <B>" + Server.HtmlEncode(Cache["Key1"] as string) + "</B>"); } %> </body> </html>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
