OutputCacheLocation Enumeration

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Gibt die gültigen Werte zum Steuern des Speicherorts der zwischengespeicherten HTTP-Antwort für eine Ressource an.

public enum class OutputCacheLocation
public enum OutputCacheLocation
type OutputCacheLocation = 
Public Enum OutputCacheLocation
Vererbung
Object
ValueType
Enum
OutputCacheLocation

Felder

Name Wert Beschreibung
Any 0

Der Ausgabecache kann sich auf dem Browserclient (wo die Anforderung stammt), auf einem Proxyserver (oder einem beliebigen anderen Server) befinden, der an der Anforderung teilnimmt, oder auf dem Server, auf dem die Anforderung verarbeitet wurde. Dieser Wert entspricht dem Public Enumerationswert.
Client 1

Der Ausgabecache befindet sich auf dem Browserclient, auf dem die Anforderung stammt. Dieser Wert entspricht dem Private Enumerationswert.
Downstream 2

Der Ausgabecache kann auf anderen HTTP 1.1-Cachegeräten als dem Ursprungsserver gespeichert werden. Dazu gehören Proxyserver und der Client, der die Anforderung gestellt hat.
Server 3

Der Ausgabecache befindet sich auf dem Webserver, auf dem die Anforderung verarbeitet wurde. Dieser Wert entspricht dem Server Enumerationswert.
None 4

Der Ausgabecache ist für die angeforderte Seite deaktiviert. Dieser Wert entspricht dem NoCache Enumerationswert.
ServerAndClient 5

Der Ausgabecache kann nur auf dem Ursprungsserver oder beim anfordernden Client gespeichert werden. Proxyserver dürfen die Antwort nicht zwischenspeichern. Dieser Wert entspricht der Kombination aus den Private Werten und Server Enumerationen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der Serverwert verwendet wird, um anzugeben, dass die Seite auf dem Webserver zwischengespeichert werden soll, auf dem die Anforderung verarbeitet wird.

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

Hinweise

Die durch diese Enumeration angegebenen Werte werden verwendet, wenn Sie eine @ OutputCache Direktive in eine .aspx Datei einschließen. Diese Werte bestimmen den Cachespeicherort für die Seitenausgabe. Weitere Informationen finden Sie unter Caching ASP.NET Pages.

Gilt für:

Weitere Informationen