HttpHeaders.Add Methode

Definition

Namespace:

System.Net.Http.Headers

Assembly:

System.Net.Http.dll

Fügt eine neue Kopfzeile und deren Werte in die HttpHeaders Auflistung ein.

Überlädt

Add(String, IEnumerable<String>)	Fügt der HttpHeaders -Auflistung die angegebene Kopfzeile und deren Werte hinzu.
Add(String, String)	Fügt der HttpHeaders -Auflistung den angegebenen Header und dessen Wert hinzu.

Add(String, IEnumerable<String>)

Quelle:

HttpHeaders.cs

Fügt der HttpHeaders -Auflistung die angegebene Kopfzeile und deren Werte hinzu.

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))

Parameter

name

String

Die Kopfzeile, die der Auflistung hinzugefügt werden soll.

values

IEnumerable<String>

Eine Liste der Kopfzeilenwerte, die der Auflistung hinzugefügt werden sollen.

Ausnahmen

ArgumentException

Der Name darf nicht null oder leer sein.

ArgumentNullException

Die Werte dürfen nicht null oder leer sein.

InvalidOperationException

Falsch verwendeter Headername. Stellen Sie sicher, dass Anforderungsheader mit HttpRequestMessage, Antwortheadern mit HttpResponseMessage und Inhaltsheadern mit HttpContent-Objekten verwendet werden.

FormatException

Das Format des Headernamens ist ungültig.

-oder-

Das Format des Headerwerts ist für diesen Kopfzeilennamen ungültig, oder die Kopfzeile unterstützt nicht mehrere Werte.

Hinweise

Kopfzeilennamen werden erzwungen, um gültige HTTP-Token zu sein, wobei ein Token als beliebiger Satz von ASCII-Buchstaben, Ziffern oder Symbolen aus dem "!#$%&'*+-.^_`|~" Satz definiert ist, der RFC9110definition entspricht. Nicht-ASCII-Zeichen sind in einem Headernamen nicht zulässig.

Die Kopfzeile values wird analysiert und überprüft.

Wenn die angegebene Kopfzeile nicht vorhanden ist, fügt die Add-Methode eine neue Kopfzeile in die Liste der Kopfzeilennamen-Wert-Paare ein.

Wenn die angegebene Kopfzeile bereits vorhanden ist, werden values zur durch Trennzeichen getrennten Liste der Werte hinzugefügt, die der Kopfzeile zugeordnet sind.

Add(String, String)

Quelle:

HttpHeaders.cs

Fügt der HttpHeaders -Auflistung den angegebenen Header und dessen Wert hinzu.

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)

Parameter

name

String

Die Kopfzeile, die der Auflistung hinzugefügt werden soll.

value

String

Der Inhalt der Kopfzeile.

Ausnahmen

ArgumentException

Der Name darf nicht null oder leer sein.

InvalidOperationException

Falsch verwendeter Headername. Stellen Sie sicher, dass Anforderungsheader mit HttpRequestMessage, Antwortheadern mit HttpResponseMessage und Inhaltsheadern mit HttpContent-Objekten verwendet werden.

FormatException

Das Format des Headernamens ist ungültig.

-oder-

Das Format des Headerwerts ist für diesen Kopfzeilennamen ungültig, oder die Kopfzeile unterstützt nicht mehrere Werte.

Hinweise

Kopfzeilennamen werden erzwungen, um gültige HTTP-Token zu sein, wobei ein Token als beliebiger Satz von ASCII-Buchstaben, Ziffern oder Symbolen aus dem "!#$%&'*+-.^_`|~" Satz definiert ist, der RFC9110definition entspricht. Nicht-ASCII-Zeichen sind in einem Headernamen nicht zulässig.

Die Kopfzeile values wird analysiert und überprüft.

Wenn die angegebene Kopfzeile nicht vorhanden ist, fügt die Add-Methode eine neue Kopfzeile in die Liste der Kopfzeilennamen-Wert-Paare ein.

Wenn die angegebene Kopfzeile bereits vorhanden ist, wird value der kommagetrennten Liste der werte hinzugefügt, die der Kopfzeile zugeordnet sind.