HttpHeaders.Add メソッド

定義

新しいヘッダーと値を HttpHeaders コレクションに挿入します。Inserts a new header and its values into the HttpHeaders collection.

オーバーロード

Add(String, IEnumerable<String>)

HttpHeaders コレクションに指定のヘッダーと値を追加します。Adds the specified header and its values into the HttpHeaders collection.

Add(String, String)

HttpHeaders コレクションに指定のヘッダーと値を追加します。Adds the specified header and its value into the HttpHeaders collection.

Add(String, IEnumerable<String>)

HttpHeaders コレクションに指定のヘッダーと値を追加します。Adds the specified header and its values into the HttpHeaders collection.

public:
 void Add(System::String ^ name, System::Collections::Generic::IEnumerable<System::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

コレクションに追加するヘッダー。The header to add to the collection.

values
IEnumerable<String>

コレクションに追加するヘッダー値のリスト。A list of header values to add to the collection.

例外

この名前を null または空にすることはできません。The name cannot be null or empty.

この値を null または空にすることはできません。The values cannot be null or empty.

誤って使用されたヘッダー名。Misused header name. 要求ヘッダーが HttpRequestMessage オブジェクトで、応答ヘッダーが HttpResponseMessage オブジェクトで、コンテンツ ヘッダーが HttpContent オブジェクトで使用されていることを確認してください。Make sure request headers are used with HttpRequestMessage, response headers with HttpResponseMessage, and content headers with HttpContent objects.

ヘッダー名の形式が無効です。The header name format is invalid.

または-or-

ヘッダーの値の改行文字の後には空白文字が必要です。New line characters in header values must be followed by a white-space character.

注釈

ヘッダー values が解析および検証されます。The header values will be parsed and validated.

指定したヘッダーが存在しない場合は、Add メソッドによって、ヘッダーの名前と値のペアのリストに新しいヘッダーが挿入されます。If the specified header does not exist, the Add method inserts a new header into the list of header name/value pairs.

指定したヘッダーが既に存在する場合は、ヘッダーに関連付けられている値のコンマ区切りリストに values が追加されます。If the specified header is already present, values are added to the comma-separated list of values associated with the header.

Add(String, String)

HttpHeaders コレクションに指定のヘッダーと値を追加します。Adds the specified header and its value into the HttpHeaders collection.

public:
 void Add(System::String ^ name, System::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

コレクションに追加するヘッダー。The header to add to the collection.

value
String

ヘッダーの内容。The content of the header.

例外

この名前を null または空にすることはできません。The name cannot be null or empty.

誤って使用されたヘッダー名。Misused header name. 要求ヘッダーが HttpRequestMessage オブジェクトで、応答ヘッダーが HttpResponseMessage オブジェクトで、コンテンツ ヘッダーが HttpContent オブジェクトで使用されていることを確認してください。Make sure request headers are used with HttpRequestMessage, response headers with HttpResponseMessage, and content headers with HttpContent objects.

ヘッダー名の形式が無効です。The header name format is invalid.

または-or-

ヘッダーの値の改行文字の後には空白文字が必要です。New line characters in header values must be followed by a white-space character.

注釈

ヘッダー value が解析および検証されます。The header value will be parsed and validated.

指定したヘッダーが存在しない場合は、Add メソッドによって、ヘッダーの名前と値のペアのリストに新しいヘッダーが挿入されます。If the specified header does not exist, the Add method inserts a new header into the list of header name/value pairs.

指定したヘッダーが既に存在する場合は、ヘッダーに関連付けられている値のコンマ区切りリストに value が追加されます。If the specified header is already present, value is added to the comma-separated list of values associated with the header.

適用対象