HttpHeaders.Add Methode

Definition

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

Der Name darf nicht null oder leer sein.

Die Werte dürfen nicht null oder leer sein.

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

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.

Gilt für:

Add(String, String)

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

Der Name darf nicht null oder leer sein.

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

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.

Gilt für: