OutputCacheLocation Enumeración

Definición

Especifica los valores válidos para controlar la ubicación de la respuesta HTTP, cuyo resultado se almacena en memoria caché, para un recurso.Specifies the valid values for controlling the location of the output-cached HTTP response for a resource.

public enum class OutputCacheLocation
public enum OutputCacheLocation
type OutputCacheLocation = 
Public Enum OutputCacheLocation
Herencia
OutputCacheLocation

Campos

Any 0

La memoria caché de resultados puede estar ubicada en el cliente de explorador (donde se originó la solicitud), en un servidor proxy (o cualquier otro servidor) que participe en la solicitud o en el servidor donde se procesó la solicitud.The output cache can be located on the browser client (where the request originated), on a proxy server (or any other server) participating in the request, or on the server where the request was processed. Este valor corresponde al valor de enumeración Public.This value corresponds to the Public enumeration value.

Client 1

La memoria caché de resultados se encuentra en el cliente de explorador donde se originó la solicitud.The output cache is located on the browser client where the request originated. Este valor corresponde al valor de enumeración Private.This value corresponds to the Private enumeration value.

Downstream 2

La memoria caché de resultados se puede almacenar en cualquier dispositivo compatible con cachés HTTP 1.1 que sea distinto del servidor de origen.The output cache can be stored in any HTTP 1.1 cache-capable devices other than the origin server. Entre ellos, se incluyen los servidores proxy y el cliente que realizó la solicitud.This includes proxy servers and the client that made the request.

None 4

La memoria caché de resultados está deshabilitada para la página solicitada.The output cache is disabled for the requested page. Este valor corresponde al valor de enumeración NoCache.This value corresponds to the NoCache enumeration value.

Server 3

La memoria caché de resultados se encuentra en el servidor web donde se procesó la solicitud.The output cache is located on the Web server where the request was processed. Este valor corresponde al valor de enumeración Server.This value corresponds to the Server enumeration value.

ServerAndClient 5

La memoria caché de resultados se puede almacenar solo en el servidor de origen o en el cliente que realiza la solicitud.The output cache can be stored only at the origin server or at the requesting client. No está permitido que los servidores proxy almacenen la respuesta en la memoria caché.Proxy servers are not allowed to cache the response. Este valor corresponde a la combinación de los valores de enumeración Private y Server.This value corresponds to the combination of the Private and Server enumeration values.

Ejemplos

En el ejemplo de código siguiente se muestra cómo se utiliza el valor del servidor para especificar que la página se debe almacenar en caché en el servidor web donde se procesa la solicitud.The following code example demonstrates how the Server value is used to specify that the page should be cached on the Web server where the request is processed.

<%@ 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>

Comentarios

Los valores especificados por esta enumeración se utilizan cuando se @ OutputCache incluye una directiva en un archivo. aspx.The values specified by this enumeration are used when you include an @ OutputCache directive in an .aspx file. Estos valores determinan la ubicación de la memoria caché para el resultado de la página.These values determine the cache location for page output. Para obtener más información, vea almacenamiento en caché de páginas ASP.net.For more information, see Caching ASP.NET Pages.

Se aplica a

Consulte también: