HttpCachePolicy.SetAllowResponseInBrowserHistory(Boolean) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

parametresi olduğunda, sunucuda yapılan ayardan bağımsız olarak HttpCacheability yanıtın istemci tarayıcı Geçmiş önbelleğinde allow kullanılabilir olmasını truesağlar.

public:
 void SetAllowResponseInBrowserHistory(bool allow);

public void SetAllowResponseInBrowserHistory (bool allow);

member this.SetAllowResponseInBrowserHistory : bool -> unit

Public Sub SetAllowResponseInBrowserHistory (allow As Boolean)

Parametreler

allow: Boolean

true istemci tarayıcısını yanıtları Geçmiş klasöründe depolamaya yönlendirmek için; aksi takdirde false. Varsayılan değer: false.

Örnekler

Aşağıdaki kod örneği, istemciyi kendi geçmişindeki SetAllowResponseInBrowserHistory yanıtları özel HttpCachePolicybir içinde depolamaya yönlendirmek için yönteminin nasıl geçersiz kılınduğunu gösterir.

<%@ Page language="c#" AutoEventWireup="true" %>
<!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" >
  <head>
    <title>HttpCachePolicy - SetAllowResponseInBrowserHistory - C# Example</title>
    <script runat="server">
      void Page_Load(Object sender, EventArgs e) 
      {
        // When HttpCacheability is set to NoCache or ServerAndNoCache 
        // the Expires HTTP header is set to -1 by default. This instructs 
        // the client to not cache responses in the History folder. Thus, 
        // each time you use the back/forward buttons, the client requests 
        // a new version of the response. 
        HttpContext.Current.Response.Cache.SetCacheability(HttpCacheability.ServerAndNoCache);
        
        // Override the ServerAndNoCache behavior by setting the SetAllowInBrowserHistory 
        // method to true. This directs the client browser to store responses in  
        // its History folder.
        HttpContext.Current.Response.Cache.SetAllowResponseInBrowserHistory(true);
        
        // Display the DateTime value.
        Label1.Text = DateTime.Now.ToLongTimeString();
      }
    </script>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">
      <h3>HttpCachePolicy - SetAllowResponseInBrowserHistory - C# Example</h3>
      
      <p>Click the Submit button a few times, and then click the Browser's Back button.<br />
        The page should be stored in the Browser's History folder</p>
        
      <p>Time: <asp:Label id="Label1" runat="server" Font-Bold="True" ForeColor="Red" /></p>
      
      <asp:Button id="Button1" runat="server" Text="Submit" />
    </form>
  </body>
</html>

<%@ Page language="VB" AutoEventWireup="true" %>
<!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" >
  <head>
    <title>HttpCachePolicy - SetAllowResponseInBrowserHistory - Visual Basic .NET Example</title>
    <script runat="server">
      Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) 
          
          ' When HttpCacheability is set to NoCache or ServerAndNoCache 
          ' the Expires HTTP header is set to -1 by default. This instructs 
          ' the client to not cache responses in the History folder. Thus, 
          ' each time you use the back/forward buttons, the client requests 
          ' a new version of the response. 
          HttpContext.Current.Response.Cache.SetCacheability(HttpCacheability.ServerAndNoCache)
          
          ' Override the ServerAndNoCache behavior by setting the SetAllowInBrowserHistory 
          ' method to true. This directs the client browser to store responses in  
          ' its History folder.
          HttpContext.Current.Response.Cache.SetAllowResponseInBrowserHistory(True)
          
          ' Display the DateTime value.
          Label1.Text = DateTime.Now.ToLongTimeString()
      End Sub
    </script>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">
      <h3>HttpCachePolicy - SetAllowResponseInBrowserHistory - Visual Basic .NET</h3>
      
      <p>Click the Submit button a few times, and then click the Browser's Back button.<br />
        The page should be stored in the Browser's History folder</p>
        
      <p>Time: <asp:Label id="Label1" runat="server" Font-Bold="True" ForeColor="Red" /></p>
      
      <asp:Button id="Button1" runat="server" Text="Submit" />
    </form>
  </body>
</html>

Açıklamalar

HttpCacheability olarak ayarlandığında NoCache veya ServerAndNoCache Expires HTTP üst bilgisi varsayılan olarak -1 olarak ayarlandığında; bu, istemciye Geçmiş klasöründeki yanıtları önbelleğe almaması gerektiğini bildirir, böylece geri/ileri düğmelerini kullandığınızda istemci her seferinde yanıtın yeni bir sürümünü ister. parametresi olarak ayarlanmış trueşekilde yöntemini allow çağırarak SetAllowResponseInBrowserHistory bu davranışı geçersiz kılabilirsiniz.

veya ServerAndNoCachedışındaki değerlere ayarlanırsaHttpCacheability, için herhangi bir değerle allow yöntemini çağırmanın SetAllowResponseInBrowserHistory hiçbir etkisi NoCache olmaz.

SetAllowResponseInBrowserHistory.NET Framework sürüm 3.5'te kullanıma sunulmuştur. Daha fazla bilgi için bkz . Sürümler ve Bağımlılıklar.

Şunlara uygulanır

Aracılığıyla paylaş