CacheItemPriority Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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. |
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. |
Default | 3 | La valeur par défaut de la priorité d'un élément mis en cache est 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. |
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. |
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. Il s'agit de la valeur par défaut. |
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. 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. |
Exemples
L’exemple suivant utilise la Cache.Insert méthode pour ajouter un élément à l’objet Cache avec son priority
paramètre défini 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 est faible en mémoire, l’objet Cache vide de manière sélective les éléments pour libérer 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é supérieure 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. Par défaut, il s’agit de Normal
.
Notes
Les éléments peuvent toujours être supprimés du cache par programmation, quelle que soit leur priorité de cache.