HttpHeaders.Add 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
將新的標頭及其值插入集合中 HttpHeaders 。
多載
| 名稱 | Description |
|---|---|
| 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> -> unitPublic Sub Add (name As String, values As IEnumerable(Of String))參數
- name
- String
要加入收藏的標頭。
- values
- IEnumerable<String>
一份要加入集合的標頭值清單。
例外狀況
名稱不能是空的。
這些值不能是空的。
標頭名稱被誤用了。 確保請求標頭與 HttpRequestMessage 一起使用，回應標頭與 HttpResponseMessage 使用，內容標頭用於 HttpContent 物件。
備註
標頭名稱被強制為有效的 HTTP 標記，標記定義為集合中 "!#$%&'*+-.^_`|~" 任何符合 RFC9110 定義的 ASCII 字母、數字或符號集合。 標頭名稱中不允許非 ASCII 字元。
標頭 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 -> unitPublic Sub Add (name As String, value As String)參數
- name
- String
要加入收藏的標頭。
- value
- String
標頭的內容。
例外狀況
名稱不能是空的。
標頭名稱被誤用了。 確保請求標頭與 HttpRequestMessage 一起使用，回應標頭與 HttpResponseMessage 使用，內容標頭用於 HttpContent 物件。
備註
標頭名稱被強制為有效的 HTTP 標記，標記定義為集合中 "!#$%&'*+-.^_`|~" 任何符合 RFC9110 定義的 ASCII 字母、數字或符號集合。 標頭名稱中不允許非 ASCII 字元。
標頭 values 會被解析並驗證。
若指定的標頭不存在， Add 該方法會在標頭名稱/值對的清單中插入新的標頭。
若指定的標頭已存在， value 則會加入與標頭相關的逗號分隔值清單中。
