HttpListenerResponse.AddHeader(String, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したヘッダーと値をこの応答の 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
ヘッダーの値。
例外
name
は null
または空の文字列 ("") です。
.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 使用します。