HttpHeaders.Add Méthode

Définition

Espace de noms:

System.Net.Http.Headers

Assembly:

System.Net.Http.dll

Insère un nouvel en-tête et ses valeurs dans la collection HttpHeaders.

Surcharges

Add(String, IEnumerable<String>)	Ajoute l’en-tête spécifié et ses valeurs dans la collection HttpHeaders.
Add(String, String)	Ajoute l’en-tête spécifié et sa valeur dans la collection HttpHeaders.

Add(String, IEnumerable<String>)

Source:

HttpHeaders.cs

Ajoute l’en-tête spécifié et ses valeurs dans la collection HttpHeaders.

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

Paramètres

name

String

En-tête à ajouter à la collection.

values

IEnumerable<String>

Liste des valeurs d’en-tête à ajouter à la collection.

Exceptions

ArgumentException

Le nom ne peut pas être null ou vide.

ArgumentNullException

Les valeurs ne peuvent pas être null ou vides.

InvalidOperationException

Nom d’en-tête mal utilisé. Assurez-vous que les en-têtes de requête sont utilisés avec HttpRequestMessage, les en-têtes de réponse avec HttpResponseMessage et les en-têtes de contenu avec des objets HttpContent.

FormatException

Le format du nom d’en-tête n’est pas valide.

-ou-

Le format de valeur d’en-tête n’est pas valide pour ce nom d’en-tête, ou l’en-tête ne prend pas en charge plusieurs valeurs.

Remarques

Les noms d’en-tête sont appliqués pour être des jetons HTTP valides, où un jeton est défini comme n’importe quel ensemble de lettres ASCII, de chiffres ou de symboles du jeu de "!#$%&'*+-.^_`|~", correspondant à la définition de RFC9110. Les caractères non ASCII ne sont pas autorisés dans un nom d’en-tête.

L’en-tête values sera analysé et validé.

Si l’en-tête spécifié n’existe pas, la méthode Add insère un nouvel en-tête dans la liste des paires nom/valeur d’en-tête.

Si l’en-tête spécifié est déjà présent, values sont ajoutés à la liste séparée par des virgules des valeurs associées à l’en-tête.

Add(String, String)

Source:

HttpHeaders.cs

Ajoute l’en-tête spécifié et sa valeur dans la collection HttpHeaders.

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)

Paramètres

name

String

En-tête à ajouter à la collection.

value

String

Contenu de l’en-tête.

Exceptions

ArgumentException

Le nom ne peut pas être null ou vide.

InvalidOperationException

Nom d’en-tête mal utilisé. Assurez-vous que les en-têtes de requête sont utilisés avec HttpRequestMessage, les en-têtes de réponse avec HttpResponseMessage et les en-têtes de contenu avec des objets HttpContent.

FormatException

Le format du nom d’en-tête n’est pas valide.

-ou-

Le format de valeur d’en-tête n’est pas valide pour ce nom d’en-tête, ou l’en-tête ne prend pas en charge plusieurs valeurs.

Remarques

Les noms d’en-tête sont appliqués pour être des jetons HTTP valides, où un jeton est défini comme n’importe quel ensemble de lettres ASCII, de chiffres ou de symboles du jeu de "!#$%&'*+-.^_`|~", correspondant à la définition de RFC9110. Les caractères non ASCII ne sont pas autorisés dans un nom d’en-tête.

L’en-tête values sera analysé et validé.

Si l’en-tête spécifié n’existe pas, la méthode Add insère un nouvel en-tête dans la liste des paires nom/valeur d’en-tête.

Si l’en-tête spécifié est déjà présent, value est ajouté à la liste séparée par des virgules des valeurs associées à l’en-tête.