HttpHeaders.Add Methode

Definition

Namespace:

System.Net.Http.Headers

Assembly:

System.Net.Http.dll

Assembly:

netstandard.dll

Fügt einen neuen Header und seine Werte in die HttpHeaders-Auflistung ein.

Überlädt

Add(String, IEnumerable<String>)	Fügt den angegebenen Header und seine Werte in die HttpHeaders-Sammlung hinzu.
Add(String, String)	Fügt den angegebenen Header und den Wert in die HttpHeaders-Sammlung hinzu.

Add(String, IEnumerable<String>)

Fügt den angegebenen Header und seine Werte in die HttpHeaders-Sammlung 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

Der Header, der der Auflistung hinzugefügt werden soll.

values

IEnumerable<String>

Eine Liste von Headerwerten, die der Sammlung 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-, Antwortheader mit HttpResponseMessage- und Inhaltsheader mit HttpContent-Objekten verwendet werden.

FormatException

Das Namensformat des Headers ist ungültig.

- oder -

Auf ein Neue-Zeile-Zeichen in Headerwerten muss ein Leerzeichen folgen.

Hinweise

Der Header values wird analysiert und überprüft.

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

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

Add(String, String)

Fügt den angegebenen Header und den Wert in die HttpHeaders-Sammlung 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

Der Header, der der Auflistung hinzugefügt werden soll.

value

String

Der Inhalt des Headers.

Ausnahmen

ArgumentException

Der Name darf nicht NULL oder leer sein.

InvalidOperationException

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

FormatException

Das Namensformat des Headers ist ungültig.

- oder -

Auf ein Neue-Zeile-Zeichen in Headerwerten muss ein Leerzeichen folgen.

Hinweise

Der Header value wird analysiert und überprüft.

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

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