HttpHeaders.Add Metoda

Definice

Obor názvů:

System.Net.Http.Headers

Sestavení:

System.Net.Http.dll

Vloží nové záhlaví a jeho hodnoty do kolekce HttpHeaders.

Přetížení

Add(String, IEnumerable<String>)	Přidá zadanou hlavičku a její hodnoty do kolekce HttpHeaders.
Add(String, String)	Přidá zadanou hlavičku a její hodnotu do kolekce HttpHeaders.

Add(String, IEnumerable<String>)

Zdroj:

HttpHeaders.cs

Přidá zadanou hlavičku a její hodnoty do kolekce 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))

Parametry

name

String

Záhlaví, které chcete přidat do kolekce.

values

IEnumerable<String>

Seznam hodnot záhlaví, které chcete přidat do kolekce.

Výjimky

ArgumentException

Název nesmí být null nebo prázdný.

ArgumentNullException

Hodnoty nesmí být null ani prázdné.

InvalidOperationException

Název zneužité hlavičky Ujistěte se, že hlavičky požadavku se používají s HttpRequestMessage, hlavičkami odpovědi s HttpResponseMessage a hlavičkami obsahu s objekty HttpContent.

FormatException

Formát názvu záhlaví je neplatný.

-nebo-

Formát hodnoty záhlaví je pro tento název záhlaví neplatný nebo záhlaví nepodporuje více hodnot.

Poznámky

Názvy hlaviček se vynucují tak, aby byly platné tokeny HTTP, kde je token definován jako libovolná sada písmen ASCII, číslic nebo symbolů ze sady "!#$%&'*+-.^_`|~" odpovídající definici RFC9110. V názvu hlavičky nejsou povolené znaky jiné než ASCII.

Hlavička values se parsuje a ověří.

Pokud zadaná hlavička neexistuje, metoda Add vloží nové záhlaví do seznamu dvojic název/hodnota záhlaví.

Pokud je zadaná hlavička již k dispozici, values se přidají do seznamu hodnot oddělených čárkami přidružených k záhlaví.

Add(String, String)

Zdroj:

HttpHeaders.cs

Přidá zadanou hlavičku a její hodnotu do kolekce 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)

Parametry

name

String

Záhlaví, které chcete přidat do kolekce.

value

String

Obsah záhlaví.

Výjimky

ArgumentException

Název nesmí být null nebo prázdný.

InvalidOperationException

Název zneužité hlavičky Ujistěte se, že hlavičky požadavku se používají s HttpRequestMessage, hlavičkami odpovědi s HttpResponseMessage a hlavičkami obsahu s objekty HttpContent.

FormatException

Formát názvu záhlaví je neplatný.

-nebo-

Formát hodnoty záhlaví je pro tento název záhlaví neplatný nebo záhlaví nepodporuje více hodnot.

Poznámky

Názvy hlaviček se vynucují tak, aby byly platné tokeny HTTP, kde je token definován jako libovolná sada písmen ASCII, číslic nebo symbolů ze sady "!#$%&'*+-.^_`|~" odpovídající definici RFC9110. V názvu hlavičky nejsou povolené znaky jiné než ASCII.

Hlavička values se parsuje a ověří.

Pokud zadaná hlavička neexistuje, metoda Add vloží nové záhlaví do seznamu dvojic název/hodnota záhlaví.

Pokud je zadaná hlavička již přítomna, value se přidá do seznamu hodnot oddělených čárkami přidružených k záhlaví.