HttpCachePolicy.SetAllowResponseInBrowserHistory メソッド

.NET Framework クラス ライブラリ リファレンス

HttpCachePolicy.SetAllowResponseInBrowserHistory メソッド

allow パラメータが true の場合、サーバーの HttpCacheability の設定に関係なく、クライアント ブラウザの履歴キャッシュに応答を格納できるようにします。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub SetAllowResponseInBrowserHistory
 ( _
    allow As Boolean _
)

Visual Basic (使用法)

Dim instance As HttpCachePolicy
Dim allow As Boolean

instance.SetAllowResponseInBrowserHistory(allow)

C#

public void SetAllowResponseInBrowserHistory
 (
    bool allow
)

C++

public:
void SetAllowResponseInBrowserHistory (
    bool allow
)

J#

public void SetAllowResponseInBrowserHistory
 (
    boolean allow
)

JScript

public function SetAllowResponseInBrowserHistory
 (
    allow : boolean
)

パラメータ

allow

応答を履歴フォルダに格納するようクライアントのブラウザに指示する場合は true。それ以外の場合は false。既定値は false です。

解説

HttpCacheability が NoCache または ServerAndNoCache に設定されている場合、Expires HTTP ヘッダーは既定で -1 に設定されます。この場合、クライアントは応答を履歴フォルダにキャッシュしません。したがって、ユーザーが [戻る] ボタンまたは [進む] ボタンをクリックした場合、クライアントはそのたびに新しい応答を要求します。この動作をオーバーライドするには、allow パラメータを true に設定して SetAllowResponseInBrowserHistory メソッドを呼び出します。

HttpCacheability が NoCache または ServerAndNoCache 以外の値に設定されている場合、SetAllowResponseInBrowserHistory メソッドを呼び出しても、allow の値に関係なく、効果はありません。

使用例

カスタムの HttpCachePolicy で SetAllowResponseInBrowserHistory メソッドをオーバーライドして、応答を履歴に格納するようクライアントに指示する方法を次のコード例に示します。

Visual Basic

<%@ Page language="VB" AutoEventWireup="true"
 %>
<HTML>
  <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>

C#

<%@ Page language="c#" AutoEventWireup="true"
 %>
<HTML>
  <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>

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
HttpCachePolicy クラス
HttpCachePolicy メンバ
System.Web 名前空間