HttpHeaders.Add メソッド

  • リファレンス

定義

名前空間:
System.Net.Http.Headers
アセンブリ:
System.Net.Http.dll
アセンブリ:
netstandard.dll

HttpHeaders コレクションに新しいヘッダーとその値を挿入します。

オーバーロード

Add(String, IEnumerable<String>)

指定したヘッダーとその値を HttpHeaders コレクションに追加します。
Add(String, String)

指定したヘッダーとその値を HttpHeaders コレクションに追加します。

Add(String, IEnumerable<String>)

ソース:
HttpHeaders.cs
ソース:
HttpHeaders.cs
ソース:
HttpHeaders.cs

指定したヘッダーとその値を HttpHeaders コレクションに追加します。

public:
 void Add(System::String ^ name, System::Collections::Generic::IEnumerable<System::String ^> ^ values);
public void Add (string name, System.Collections.Generic.IEnumerable<string> values);
public void Add (string name, System.Collections.Generic.IEnumerable<string?> values);
member this.Add : string * seq<string> -> unit
Public Sub Add (name As String, values As IEnumerable(Of String))

パラメーター

name
String

コレクションに追加するヘッダー。

values
IEnumerable<String>

コレクションに追加するヘッダー値の一覧。

例外

ArgumentException

名前を null または空にすることはできません。

ArgumentNullException

値を null または空にすることはできません。

InvalidOperationException

誤用されたヘッダー名。 要求ヘッダーが HttpRequestMessage、HttpResponseMessage を含む応答ヘッダー、および HttpContent オブジェクトを含むコンテンツ ヘッダーで使用されていることを確認します。

FormatException

ヘッダー名の形式が無効です。

-又は-

ヘッダー値の形式がこのヘッダー名に対して無効であるか、ヘッダーが複数の値をサポートしていません。

注釈

ヘッダー名は有効な HTTP トークンに適用されます。トークンは、"!#$%&'*+-.^_`|~" セットの ASCII 文字、数字、または記号のセットとして定義され、RFC9110の定義と一致します。 ASCII 以外の文字はヘッダー名では使用できません。

ヘッダー values が解析され、検証されます。

指定したヘッダーが存在しない場合、Add メソッドはヘッダー名と値のペアの一覧に新しいヘッダーを挿入します。

指定したヘッダーが既に存在する場合は、values ヘッダーに関連付けられている値のコンマ区切りのリストに追加されます。

適用対象

Add(String, String)

ソース:
HttpHeaders.cs
ソース:
HttpHeaders.cs
ソース:
HttpHeaders.cs

指定したヘッダーとその値を HttpHeaders コレクションに追加します。

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

パラメーター

name
String

コレクションに追加するヘッダー。

value
String

ヘッダーの内容。

例外

ArgumentException

名前を null または空にすることはできません。

InvalidOperationException

誤用されたヘッダー名。 要求ヘッダーが HttpRequestMessage、HttpResponseMessage を含む応答ヘッダー、および HttpContent オブジェクトを含むコンテンツ ヘッダーで使用されていることを確認します。

FormatException

ヘッダー名の形式が無効です。

-又は-

ヘッダー値の形式がこのヘッダー名に対して無効であるか、ヘッダーが複数の値をサポートしていません。

注釈

ヘッダー名は有効な HTTP トークンに適用されます。トークンは、"!#$%&'*+-.^_`|~" セットの ASCII 文字、数字、または記号のセットとして定義され、RFC9110の定義と一致します。 ASCII 以外の文字はヘッダー名では使用できません。

ヘッダー values が解析され、検証されます。

指定したヘッダーが存在しない場合、Add メソッドはヘッダー名と値のペアの一覧に新しいヘッダーを挿入します。

指定したヘッダーが既に存在する場合、value はヘッダーに関連付けられている値のコンマ区切りのリストに追加されます。

適用対象