CacheItemPriority Énumération

Définition

Spécifie la priorité relative des éléments stockés dans l'objet Cache.Specifies the relative priority of items stored in the Cache object.

public enum class CacheItemPriority
public enum CacheItemPriority
type CacheItemPriority = 
Public Enum CacheItemPriority
Héritage
CacheItemPriority

Champs

AboveNormal 4

Les éléments du cache ayant ce niveau de priorité risquent moins d'être supprimés lorsque le serveur libère de la mémoire système que ceux qui ont une priorité Normal assignée.Cache items with this priority level are less likely to be deleted as the server frees system memory than those assigned a Normal priority.

BelowNormal 2

Les éléments du cache ayant ce niveau de priorité risquent plus d'être supprimés du cache lorsque le serveur libère de la mémoire système que ceux qui ont une priorité Normal assignée.Cache items with this priority level are more likely to be deleted from the cache as the server frees system memory than items assigned a Normal priority.

Default 3

La valeur par défaut de la priorité d'un élément mis en cache est Normal.The default value for a cached item's priority is Normal.

High 5

Les éléments du cache ayant ce niveau de priorité ont le moins de chances d'être supprimés du cache lorsque le serveur libère de la mémoire système.Cache items with this priority level are the least likely to be deleted from the cache as the server frees system memory.

Low 1

Les éléments du cache ayant ce niveau de priorité sont ceux qui risquent le plus d'être supprimés du cache lorsque le serveur libère de la mémoire système.Cache items with this priority level are the most likely to be deleted from the cache as the server frees system memory.

Normal 3

Les éléments du cache ayant ce niveau de priorité seront vraisemblablement supprimés du cache lorsque le serveur libérera de la mémoire système après ceux qui ont une priorité Low ou BelowNormal.Cache items with this priority level are likely to be deleted from the cache as the server frees system memory only after those items with Low or BelowNormal priority. Il s'agit de la valeur par défaut.This is the default.

NotRemovable 6

Les éléments du cache ayant ce niveau de priorité ne seront pas supprimés automatiquement du cache lorsque le serveur libérera de la mémoire système.The cache items with this priority level will not be automatically deleted from the cache as the server frees system memory. Toutefois, les éléments ayant ce niveau de priorité sont supprimés avec d'autres éléments en fonction de l'heure d'expiration décalée ou absolue de l'élément.However, items with this priority level are removed along with other items according to the item's absolute or sliding expiration time.

Exemples

L’exemple suivant utilise la Cache.Insert méthode pour ajouter un élément à l' Cache objet avec le priority paramètre défini sur High :The following example uses the Cache.Insert method to add an item to the Cache object with its priority parameter set to High:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script language="c#" runat="server">
    public void Page_Load(Object sender, EventArgs e) {
        String connectionString;
        connectionString = "Data Source=localhost;Integrated Security=SSPI";
        Cache.Insert("DSN", connectionString, null, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, null);
    }
</script>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    Public Sub Page_Load(sender As Object, e As EventArgs)
        Dim connectionString As String
        connectionString = "Data Source=localhost;Integrated Security=SSPI"
        Cache.Insert("DSN", connectionString, Nothing, DateTime.Now.AddMinutes(2), TimeSpan.Zero, CacheItemPriority.High, Nothing)
    End Sub
</script>

Remarques

Lorsque le serveur Web hébergeant une application ASP.NET manque de mémoire, l' Cache objet vide de manière sélective les éléments pour libérer de la mémoire système.When the Web server hosting an ASP.NET application runs low on memory, the Cache object selectively purges items to free system memory. Lorsqu’un élément est ajouté au cache, vous pouvez lui assigner une priorité relative par rapport aux autres éléments stockés dans le cache.When an item is added to the cache, you can assign it a relative priority compared to the other items stored in the cache. Les éléments auxquels vous affectez des valeurs de priorité plus élevée sont moins susceptibles d’être supprimés du cache lorsque le serveur traite un grand nombre de requêtes, alors que les éléments auxquels vous affectez des valeurs de priorité inférieure sont plus susceptibles d’être supprimés.Items to which you assign higher priority values are less likely to be deleted from the cache when the server is processing a large number of requests, whereas items to which you assign lower priority values are more likely to be deleted. La valeur par défaut est Normal.The default is Normal.

Notes

Les éléments peuvent toujours être supprimés du cache par programme, quelle que soit leur priorité de cache.Items can always be removed from the cache programmatically, regardless of their cache priority.

S’applique à

Voir aussi