HttpHeaders.Add Methode

Definition

Namespace:

System.Net.Http.Headers

Assembly:

System.Net.Http.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>)

Quelle:

HttpHeaders.cs

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

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 einen neuen Header in die Liste der Headernamen-Wert-Paare ein.

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

Add(String, String)

Quelle:

HttpHeaders.cs

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

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 einen neuen Header in die Liste der Headernamen-Wert-Paare ein.

Wenn der angegebene Header bereits vorhanden ist, wird der durch Trennzeichen getrennten Liste der Werte hinzugefügt, value die dem Header zugeordnet sind.