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

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