OutputCacheLocation Énumération

Définition

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

Spécifie les valeurs valides pour contrôler l’emplacement de la réponse HTTP mise en cache de sortie pour une ressource.

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

Champs

Nom Valeur Description
Any 0

Le cache de sortie peut se trouver sur le client de navigateur (où la demande provient), sur un serveur proxy (ou tout autre serveur) participant à la demande, ou sur le serveur sur lequel la demande a été traitée. Cette valeur correspond à la valeur d’énumération Public .
Client 1

Le cache de sortie se trouve sur le client du navigateur où provient la requête. Cette valeur correspond à la valeur d’énumération Private .
Downstream 2

Le cache de sortie peut être stocké dans tous les appareils compatibles avec le cache HTTP 1.1 autres que le serveur d’origine. Cela inclut les serveurs proxy et le client qui a effectué la requête.
Server 3

Le cache de sortie se trouve sur le serveur Web où la demande a été traitée. Cette valeur correspond à la valeur d’énumération Server .
None 4

Le cache de sortie est désactivé pour la page demandée. Cette valeur correspond à la valeur d’énumération NoCache .
ServerAndClient 5

Le cache de sortie peut être stocké uniquement sur le serveur d’origine ou sur le client demandeur. Les serveurs proxy ne sont pas autorisés à mettre en cache la réponse. Cette valeur correspond à la combinaison des valeurs d’énumération et Server de l’énumérationPrivate.

Exemples

L’exemple de code suivant montre comment la valeur du serveur est utilisée pour spécifier que la page doit être mise en cache sur le serveur Web où la requête est traitée.

<%@ Import Namespace="System.IO" %>
<%@ Import Namespace="System.Data" %>

// The following OutputCache directive uses the OutputCacheLocation.Server
// enumeration value to allow output caching only on the origin server.
<%@ outputcache duration="10" varybyparam="none" Location="Server" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script language="C#" runat="server">

    protected void Page_Load(Object Src, EventArgs E) 
    {
        DataSet ds = new DataSet();

        FileStream fs = new FileStream(Server.MapPath("schemadata.xml"),FileMode.Open,FileAccess.Read);
        StreamReader reader = new StreamReader(fs);
        ds.ReadXml(reader);
        fs.Close();

        DataView Source = new DataView(ds.Tables[0]);

        // Use the LiteralControl constructor to create a new
        // instance of the class.
        LiteralControl myLiteral = new LiteralControl();

        // Set the LiteralControl.Text property to an HTML
        // string and the TableName value of a data source.
        myLiteral.Text = "<h6><font face=\"verdana\">Caching an XML Table: " + Source.Table.TableName + " </font></h6>";

        MyDataGrid.DataSource = Source;
        MyDataGrid.DataBind();

        TimeMsg.Text = DateTime.Now.ToString("G");

     }

  </script>

<head runat="server">
    <title>Using the OutputCacheLocation Enumeration </title>
</head>
<body>

  <h6>Using the OutputCacheLocation Enumeration </h6>
  
  <form id="form1" runat="server">
    <ASP:DataGrid id="MyDataGrid" runat="server"
      Width="900"
      BackColor="#ccccff"
      BorderColor="black"
      ShowFooter="false"
      CellPadding="3"
      CellSpacing="0"
      Font-Names="Verdana"
      Font-Size="8pt"
      HeaderStyle-BackColor="#aaaadd"
      EnableViewState="false"
    />

    <i>Page last generated on:</i> <asp:label id="TimeMsg" runat="server" />

  </form>
</body>
</html>

<%@ Import Namespace="System.IO" %>
<%@ Import Namespace="System.Data" %>

' The following OutputCache directive uses the OutputCacheLocation.Server
' enumeration value to allow output caching only on the origin server.
<%@ outputcache duration="10" varybyparam="none" Location="Server" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<script language="vb" runat="server">

   Protected Sub Page_Load(Src As [Object], E As EventArgs)
     Dim ds As New DataSet()
   
     Dim fs As New FileStream(Server.MapPath("schemadata.xml"),FileMode.Open,FileAccess.Read)

   
   Dim reader As New StreamReader(fs)
     
      ds.ReadXml(reader)
      fs.Close()
 
   
   Dim [Source] As New DataView(ds.Tables(0))
      
   MyDataGrid.DataSource = [Source]   
   MyDataGrid.DataBind()
   
   TimeMsg.Text = DateTime.Now.ToString("G")

 End Sub 'Page_Load 

  </script>

<head runat="server">
    <title>Using the OutputCacheLocation Enumeration </title>
</head>
<body>
  <h4>Using the OutputCacheLocation Enumeration </h4>
  
  <form id="form1" runat="server">
    <ASP:DataGrid id="MyDataGrid" runat="server"
      Width="900"
      BackColor="#ccccff"
      BorderColor="black"
      ShowFooter="false"
      CellPadding="3"
      CellSpacing="0"
      Font-Names="Verdana"
      Font-Size="8pt"
      HeaderStyle-BackColor="#aaaadd"
      EnableViewState="false"
    />

    <i>Page last generated on:</i> <asp:label id="TimeMsg" runat="server" />

  </form>
</body>
</html>

Remarques

Les valeurs spécifiées par cette énumération sont utilisées lorsque vous incluez une @ OutputCache directive dans un fichier .aspx. Ces valeurs déterminent l’emplacement du cache pour la sortie de page. Pour plus d’informations, consultez Caching ASP.NET Pages.

S’applique à

Voir aussi