OutputCacheLocation Wyliczenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określa prawidłowe wartości do kontrolowania lokalizacji odpowiedzi HTTP w pamięci podręcznej danych wyjściowych dla zasobu.
public enum class OutputCacheLocation
public enum OutputCacheLocation
type OutputCacheLocation =
Public Enum OutputCacheLocation
- Dziedziczenie
Pola
Any | 0 | Pamięć podręczna danych wyjściowych może znajdować się na kliencie przeglądarki (gdzie pochodzi żądanie), na serwerze proxy (lub innym serwerze) uczestniczącym w żądaniu lub na serwerze, na którym zostało przetworzone żądanie. Ta wartość odpowiada Public wartości wyliczenia. |
Client | 1 | Pamięć podręczna danych wyjściowych znajduje się na kliencie przeglądarki, na którym pochodzi żądanie. Ta wartość odpowiada Private wartości wyliczenia. |
Downstream | 2 | Pamięć podręczna danych wyjściowych może być przechowywana na dowolnych urządzeniach obsługujących pamięć podręczną HTTP 1.1 innych niż serwer źródłowy. Obejmuje to serwery proxy i klienta, który złożył żądanie. |
None | 4 | Pamięć podręczna danych wyjściowych jest wyłączona dla żądanej strony. Ta wartość odpowiada NoCache wartości wyliczenia. |
Server | 3 | Pamięć podręczna danych wyjściowych znajduje się na serwerze sieci Web, na którym zostało przetworzone żądanie. Ta wartość odpowiada Server wartości wyliczenia. |
ServerAndClient | 5 | Pamięć podręczna danych wyjściowych może być przechowywana tylko na serwerze źródłowym lub na żądającym kliencie. Serwery proxy nie mogą buforować odpowiedzi. Ta wartość odpowiada kombinacji Private wartości i Server wyliczenia. |
Przykłady
Poniższy przykład kodu pokazuje, jak wartość serwera jest używana do określenia, że strona powinna być buforowana na serwerze sieci Web, na którym jest przetwarzane żądanie.
<%@ 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>
Uwagi
Wartości określone przez tę wyliczenie są używane podczas dołączania @ OutputCache
dyrektywy do pliku .aspx. Te wartości określają lokalizację pamięci podręcznej dla danych wyjściowych strony. Aby uzyskać więcej informacji, zobacz Buforowanie stron ASP.NET.