HttpHeaders.Add Methode

Definition

Namespace:: System.Net.Http.Headers

Assembly:: System.Net.Http.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Überlädt

Name	Beschreibung
Add(String, IEnumerable<String>)	Fügt der Auflistung die angegebene Kopfzeile und deren HttpHeaders Werte hinzu.
Add(String, String)	Fügt der Auflistung die angegebene Kopfzeile und den HttpHeaders zugehörigen Wert hinzu.

Add(String, IEnumerable<String>)

Fügt der Auflistung die angegebene Kopfzeile und deren HttpHeaders 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, die der Definition RFC9110 entsprechen. 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 sie der durch Trennzeichen getrennten Liste von Werten hinzugefügt, values die der Kopfzeile zugeordnet sind.

Gilt für:

Add(String, String)

Fügt der Auflistung die angegebene Kopfzeile und den HttpHeaders zugehörigen 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)