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 集合中。

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

標頭名稱格式無效。

-或-

標頭值中的新行字元後面必須接著空白字元。

備註

標頭 values 將會經過剖析和驗證。

如果指定的標頭不存在，方法會將 Add 新的標頭插入標頭名稱/值組清單中。

如果指定的標頭已經存在， values 則會新增至與標頭相關聯的值逗號分隔清單。

Add(String, String)

將指定的標頭及其值加入至 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

標頭名稱格式無效。

-或-

標頭值中的新行字元後面必須接著空白字元。

備註

標頭 value 將會經過剖析和驗證。

如果指定的標頭不存在，方法會將 Add 新的標頭插入標頭名稱/值組清單中。

如果指定的標頭已經存在， value 則會新增至與標頭相關聯的值逗號分隔清單。