HttpResponse.AppendHeader メソッド

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

HttpResponse.AppendHeader メソッド

HTTP ヘッダーを出力ストリームに追加します。

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

Visual Basic (宣言)

Public Sub AppendHeader ( _
    name As String, _
    value As String _
)

Visual Basic (使用法)

Dim instance As HttpResponse
Dim name As String
Dim value As String

instance.AppendHeader(name, value)

C#

public void AppendHeader (
    string name,
    string value
)

C++

public:
void AppendHeader (
    String^ name, 
    String^ value
)

J#

public void AppendHeader (
    String name, 
    String value
)

JScript

public function AppendHeader (
    name : String, 
    value : String
)

パラメータ

name

出力ストリームに追加する HTTP ヘッダーの名前。

value

ヘッダーに追加する文字列。

例外

例外の種類	条件
HttpException	HTTP ヘッダーが送信された後にヘッダーが追加されています。

解説

AppendHeader メソッドを使用してキャッシュ固有のヘッダーを送信すると同時にキャッシュ オブジェクト モデル (Cache) を使用してキャッシュ ポリシーを設定すると、キャッシングに関連する HTTP 応答ヘッダー (Cache-Control、Expires、Last-Modified、Pragma、および Vary) は、キャッシュ オブジェクト モデルが使用されるときに削除されます。この動作によって、ASP.NET では、制限的な設定を保持できます。ユーザー コントロールを含むページを例に説明します。ページ上のコントロールがキャッシュ ポリシーと競合した場合は、最も制限的なキャッシュ ポリシーが使用されます。SetCacheability への呼び出しをとおして、あるユーザー コントロールでヘッダー "Cache-Control: Public" を設定し、別のコントロールでより制限的なヘッダー "Cache-Control: Private" を設定すると、"Cache-Control: Private" ヘッダーが応答と共に送信されます。

使用例

AppendHeader メソッドを呼び出して、要求元クライアントに送信される HttpResponse オブジェクトにカスタム ヘッダーを追加するコード例を次に示します。

Visual Basic

Response.AppendHeader("CustomAspNetHeader", "Value1")

C#

Response.AppendHeader("CustomAspNetHeader", "Value1");

J#

get_Response().AppendHeader("CustomAspNetHeader", "Value1");

プラットフォーム

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、1.0

参照

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