HTTP ヘッダーを出力ストリームに追加します。
名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文
'宣言
Public Sub AppendHeader ( _
name As String, _
value As String _
)
'使用
Dim instance As HttpResponse
Dim name As String
Dim value As String
instance.AppendHeader(name, value)
public void AppendHeader (
string name,
string value
)
public:
void AppendHeader (
String^ name,
String^ value
)
public void AppendHeader (
String name,
String value
)
public function AppendHeader (
name : String,
value : String
)
適用できません。
パラメータ
- name
出力ストリームに追加する HTTP ヘッダーの名前。
- value
ヘッダーに追加する文字列。
例外
| 例外の種類 | 条件 |
|---|---|
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 オブジェクトにカスタム ヘッダーを追加するコード例を次に示します。
Response.AppendHeader("CustomAspNetHeader", "Value1")
Response.AppendHeader("CustomAspNetHeader", "Value1");
get_Response().AppendHeader("CustomAspNetHeader", "Value1");
プラットフォーム
Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition
Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。
バージョン情報
.NET Framework
サポート対象 : 3.0,2.0,1.1,1.0