HttpListenerResponse.AddHeader(String, String) メソッド

定義

指定したヘッダーと値をこの応答の HTTP ヘッダーに追加します。

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

パラメーター

name
String

設定する HTTP ヘッダーの名前。

value
String

name ヘッダーの値。

例外

namenull または空の文字列 ("") です。

指定したヘッダーの指定が許可されていません。

- または -

name または value に無効な文字が含まれています。

.NET Framework および .NET Core バージョン 2.0 - 3.1 のみ: value の長さが 65,535 文字を超えています。

次のコード例では、このプロパティを使用してヘッダーを追加する方法を示します。

public static void SetExpirationDate(long seconds, HttpListenerResponse response)
{
    response.AddHeader("Expires", seconds.ToString());
}
Public Shared Sub SetExpirationDate(ByVal seconds As Long, ByVal response As HttpListenerResponse)
    response.AddHeader("Expires", seconds.ToString())
End Sub

注釈

このメソッドの呼び出しは、 プロパティによって返されるコレクションで メソッドを呼び出 Set すことと Headers 同じです。

name 指定されたヘッダーが存在しない場合、このメソッドはプロパティのコレクションに新しいヘッダーを Headers 挿入します。 が コレクションに存在する場合 name 、このメソッドは既存の値を に value置き換えます。 既存の値を置き換えずに既存のヘッダーに値を追加するには、 メソッドを使用します AppendHeader

適用対象

こちらもご覧ください