HttpListenerResponse.AddHeader(String, String) Méthode

  • Référence

Définition

Espace de noms:
System.Net
Assembly:
System.Net.HttpListener.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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é n’existe name pas, cette méthode insère un nouvel en-tête dans la collection de la Headers propriété. Si name elle est présente 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