HttpHeaders.Add 方法

定义

命名空间:

System.Net.Http.Headers

程序集:

System.Net.Http.dll

将新的标头及其值插入 HttpHeaders 集合中。

重载

Add(String, IEnumerable<String>)	添加指定的标头及其值到 HttpHeaders 集合中。
Add(String, String)	添加指定的标头及其值到 HttpHeaders 集合中。

Add(String, IEnumerable<String>)

Source:

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);

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

标头名称格式无效。

- 或 -

标头值中的新行字符必须后接一个空格。

注解

将分析和验证标头 values 。

如果指定的标头不存在，该方法会将 Add 新的标头插入到标头名称/值对列表中。

如果指定的标头已存在， values 则会添加到与标头关联的值的逗号分隔列表中。

Add(String, String)

Source:

HttpHeaders.cs

添加指定的标头及其值到 HttpHeaders 集合中。

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

要添加到集合中的标头。

value

String

标头的内容。

例外

ArgumentException

名称不能为 NULL 或为空。

InvalidOperationException

标头名称使用不当。 请确保请求头与 HttpRequestMessage 一起使用、响应头与 HttpResponseMessage 一起使用，而内容头与 HttpContent 对象一起使用。

FormatException

标头名称格式无效。

- 或 -

标头值中的新行字符必须后接一个空格。

注解

将分析和验证标头 value 。

如果指定的标头不存在，该方法会将 Add 新的标头插入到标头名称/值对列表中。

如果指定的标头已存在， value 将 添加到与标头关联的值的逗号分隔列表中。