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

标头名称格式无效。

-或-

此标头名称的标头值格式无效，或者标头不支持多个值。

注解

标头名称强制为有效的 HTTP 令牌，其中令牌定义为 "!#$%&'*+-.^_`|~" 集中的任意一组 ASCII 字母、数字或符号，匹配 RFC9110的定义。 标头名称中不允许使用非 ASCII 字符。

将分析并验证标头 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

标头名称格式无效。

-或-

此标头名称的标头值格式无效，或者标头不支持多个值。

注解

标头名称强制为有效的 HTTP 令牌，其中令牌定义为 "!#$%&'*+-.^_`|~" 集中的任意一组 ASCII 字母、数字或符号，匹配 RFC9110的定义。 标头名称中不允许使用非 ASCII 字符。

将分析并验证标头 values。

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

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