CacheItemPriority Énumération

Définition

Espace de noms:
System.Web.Caching
Assembly:
System.Web.dll

Spécifie la priorité relative des éléments stockés dans l’objet Cache.

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

Champs

Nom Valeur Description
Low 1

Les éléments de cache avec ce niveau de priorité sont les plus susceptibles d’être supprimés du cache, car le serveur libère la mémoire système.
BelowNormal 2

Les éléments de cache avec ce niveau de priorité sont plus susceptibles d’être supprimés du cache, car le serveur libère la mémoire système que les éléments affectés à une Normal priorité.
Default 3

La valeur par défaut de la priorité d’un élément mis en cache est Normal.
Normal 3

Les éléments de cache avec ce niveau de priorité sont susceptibles d’être supprimés du cache, car le serveur libère la mémoire système uniquement après ces éléments avec Low ou BelowNormal priorité. Il s’agit de la valeur par défaut.
AboveNormal 4

Les éléments de cache avec ce niveau de priorité sont moins susceptibles d’être supprimés, car le serveur libère la mémoire système que celles affectées d’une Normal priorité.
High 5

Les éléments de cache avec ce niveau de priorité sont les moins susceptibles d’être supprimés du cache, car le serveur libère la mémoire système.
NotRemovable 6

Les éléments de cache avec ce niveau de priorité ne seront pas automatiquement supprimés du cache, car le serveur libère la mémoire système. Toutefois, les éléments avec ce niveau de priorité sont supprimés avec d’autres éléments en fonction de l’heure d’expiration absolue ou glissante de l’élément.

Exemples

L’exemple suivant utilise la Cache.Insert méthode pour ajouter un élément à l’objet Cache avec son priority jeu de paramètres sur 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 s’exécute en mémoire faible, l’objet Cache vide de manière sélective les é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. Les éléments auxquels vous affectez des valeurs de priorité plus élevées sont moins susceptibles d’être supprimés du cache lorsque le serveur traite un grand nombre de requêtes, tandis que les éléments auxquels vous attribuez des valeurs de priorité inférieure sont plus susceptibles d’être supprimés. La valeur par défaut est Normal.

Note

Les éléments peuvent toujours être supprimés du cache par programmation, quelle que soit leur priorité de cache.

S’applique à

Voir aussi