HttpListenerResponse.AddHeader(String, String) Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.HttpListener.dll

Source:

HttpListenerResponse.cs

Ajoute l'en-tête et la valeur spécifiés aux en-têtes HTTP pour cette réponse.

public:
 void AddHeader(System::String ^ name, System::String ^ value);

public void AddHeader (string name, string value);

member this.AddHeader : string * string -> unit

Public Sub AddHeader (name As String, value As String)

Paramètres

name

String

Nom de l'en-tête HTTP à définir.

value

String

Valeur de l'en-tête name.

Exceptions

ArgumentNullException

name ou null est une chaîne vide ("").

ArgumentException

Vous n'êtes pas autorisé à spécifier une valeur pour l'en-tête spécifié.

- ou -

name ou value contient des caractères non valides.

ArgumentOutOfRangeException

Versions .NET Framework et .NET Core versions 2.0 - 3.1 uniquement : la longueur de value est supérieure à 65 535 caractères.

Exemples

L’exemple de code suivant illustre l’ajout d’un en-tête à l’aide de cette propriété.

public static void SetExpirationDate(long seconds, HttpListenerResponse response)
{
    response.AddHeader("Expires", seconds.ToString());
}

Public Shared Sub SetExpirationDate(ByVal seconds As Long, ByVal response As HttpListenerResponse)
    response.AddHeader("Expires", seconds.ToString())
End Sub

Remarques

L’appel de cette méthode équivaut à appeler la Set méthode sur la collection retournée par la Headers propriété .

Si l’en-tête spécifié dans name n’existe pas, cette méthode insère un nouvel en-tête dans la collection de la Headers propriété. Si name est présent dans la collection, cette méthode remplace la valeur existante par value. Pour ajouter une valeur à un en-tête existant sans remplacer la valeur existante, utilisez la AppendHeader méthode .

Voir aussi

• HttpListener
• HttpListenerContext
• HttpListenerRequest
• WebHeaderCollection