OutputCacheLocation-Enumeration
Gibt die gültigen Werte zum Steuern des Speicherorts der zwischengespeicherten Ausgabe der HTTP-Antwort für eine Ressource an.
Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Enumeration OutputCacheLocation
'Usage
Dim instance As OutputCacheLocation
public enum OutputCacheLocation
public enum class OutputCacheLocation
public enum OutputCacheLocation
public enum OutputCacheLocation
Member
Membername | Beschreibung | |
---|---|---|
Any | Der Speicherort des Ausgabecaches kann sich auf dem Browserclient (von dem die Anforderung stammt), auf einem an der Anforderung beteiligten Proxyserver (bzw. beliebigen anderen beteiligten Servern) oder auf dem Server befinden, auf dem die Anforderung verarbeitet wurde. Dieser Wert entspricht dem HttpCacheability.Public-Enumerationswert. | |
Client | Der Ausgabecache befindet sich auf dem Browserclient, von dem die Anforderung stammt. Dieser Wert entspricht dem HttpCacheability.Private-Enumerationswert. | |
Downstream | Der Ausgabecache kann in jedem cachefähigen HTTP 1.1-Gerät gespeichert werden, jedoch nicht auf dem Ausgangsserver. Dies schließt Proxyserver und den Client ein, von dem die Anforderung stammt. | |
None | Der Ausgabecache wird für die angeforderte Seite deaktiviert. Dieser Wert entspricht dem HttpCacheability.NoCache-Enumerationswert. | |
Server | Der Ausgabecache befindet sich auf dem Webserver, auf dem die Anforderung verarbeitet wurde. Dieser Wert entspricht dem HttpCacheability.Server-Enumerationswert. | |
ServerAndClient | Der Ausgabecache kann nur auf dem Ausgangsserver oder dem anfordernden Client gespeichert werden. Die Zwischenspeicherung der Antwort durch Proxyserver ist nicht zulässig. Dieser Wert entspricht der Kombination des HttpCacheability.Private-Enumerationswerts und HttpCacheability.Server-Enumerationswerts. |
Hinweise
Die von dieser Enumeration angegebenen Werte werden verwendet, wenn einer ASPX-Datei eine @ OutputCache-Direktive hinzugefügt wird. Diese Werte bestimmen den Cachespeicherort für die Seitenausgabe. Weitere Informationen finden Sie unter Zwischenspeichern von ASP.NET-Seiten.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe des Server-Werts angegeben wird, 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" %>
<html>
<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>
<body>
<h4>Using the OutputCacheLocation Enumeration </h4>
<form runat=server>
<ASP:DataGrid id="MyDataGrid" runat="server"
Width="900"
BackColor="#ccccff"
BorderColor="black"
ShowFooter="false"
CellPadding=3
CellSpacing="0"
Font-Name="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" %>
<html>
<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>
<body>
<h6>Using the OutputCacheLocation Enumeration </h6>
<form runat=server>
<ASP:DataGrid id="MyDataGrid" runat="server"
Width="900"
BackColor="#ccccff"
BorderColor="black"
ShowFooter="false"
CellPadding=3
CellSpacing="0"
Font-Name="Verdana"
Font-Size="8pt"
HeaderStyle-BackColor="#aaaadd"
EnableViewState="false"
/>
<i>Page last generated on:</i> <asp:label id="TimeMsg" runat="server" />
</form>
</body>
</html>
// 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" %>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0