HttpResponse.AppendHeader(String, String) メソッド

定義

名前空間:
System.Web
アセンブリ:
System.Web.dll

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

public:
 void AppendHeader(System::String ^ name, System::String ^ value);
public void AppendHeader(string name, string value);
member this.AppendHeader : string * string -> unit
Public Sub AppendHeader (name As String, value As String)

パラメーター

name
String

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

value
String

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

例外

HttpException

ヘッダーは、HTTP ヘッダーが送信された後に追加されます。

例

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

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

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

注釈

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

標準の HTTP/1.1 ヘッダーの一覧については、「 ヘッダー フィールドの定義」を参照してください。

適用対象