Partager via


HttpListenerResponse.AddHeader(String, String) Méthode

Définition

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

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

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.

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 .

S’applique à

Voir aussi