HttpHeaders.Add 方法

定義

命名空間:

System.Net.Http.Headers

組件:

System.Net.Http.dll

將新的標頭及其值插入 HttpHeaders 集合中。

多載

Add(String, IEnumerable<String>)	將指定的標頭及其值加入至 HttpHeaders 集合中。
Add(String, String)	將指定的標頭及其值加入至 HttpHeaders 集合中。

Add(String, IEnumerable<String>)

來源:

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)

來源:

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 會新增至與標頭相關聯的逗號分隔值清單。