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

  • リファレンス

定義

名前空間:
System.Net
アセンブリ:
System.Net.HttpListener.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll
ソース:
HttpListenerResponse.cs
ソース:
HttpListenerResponse.cs
ソース:
HttpListenerResponse.cs

指定したヘッダーと値をこの応答の 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 ヘッダーの値。

例外

ArgumentNullException

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

ArgumentException

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

- または -

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

ArgumentOutOfRangeException

.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 。

適用対象

こちらもご覧ください