共用方式為


HttpHeaders.Add 方法

定義

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

多載

Add(String, IEnumerable<String>)

將指定的標頭及其值加入至 HttpHeaders 集合中。

Add(String, String)

將指定的標頭及其值加入至 HttpHeaders 集合中。

Add(String, IEnumerable<String>)

來源:
HttpHeaders.cs
來源:
HttpHeaders.cs
來源:
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);
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>

要加入至集合的標頭值清單。

例外狀況

名稱不可為 Null 或空白。

值不可為 Null 或空白。

標頭名稱使用錯誤。 請確認要求標頭搭配 HttpRequestMessage 物件使用;回應標頭搭配 HttpResponseMessage 物件使用;而內容標頭則搭配 HttpContent 物件使用。

標頭名稱格式無效。

-或-

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

備註

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

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

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

適用於

Add(String, String)

來源:
HttpHeaders.cs
來源:
HttpHeaders.cs
來源:
HttpHeaders.cs

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

標頭的內容。

例外狀況

名稱不可為 Null 或空白。

標頭名稱使用錯誤。 請確認要求標頭搭配 HttpRequestMessage 物件使用;回應標頭搭配 HttpResponseMessage 物件使用;而內容標頭則搭配 HttpContent 物件使用。

標頭名稱格式無效。

-或-

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

備註

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

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

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

適用於