HttpResponse.AppendHeader(String, String) Méthode

Définition

Espace de noms:

System.Web

Assembly:

System.Web.dll

Ajoute un en-tête HTTP au flux de sortie.

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

public void AppendHeader (string name, string value);

member this.AppendHeader : string * string -> unit

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

Paramètres

name

String

Nom de l'en-tête HTTP à ajouter au flux de sortie.

value

String

Chaîne à ajouter à l'en-tête.

Exceptions

HttpException

L'en-tête est ajouté une fois que les en-têtes HTTP ont été envoyés.

Exemples

L’exemple suivant appelle la AppendHeader méthode pour ajouter un en-tête personnalisé à l’objet HttpResponse envoyé au client demandeur.

Response.AppendHeader("CustomAspNetHeader", "Value1");

Response.AppendHeader("CustomAspNetHeader", "Value1")

Remarques

Si vous utilisez la AppendHeader méthode pour envoyer des en-têtes spécifiques au cache et en même temps utiliser le modèle objet de cache (Cache) pour définir la stratégie de cache, les en-têtes de réponse HTTP relatifs à la mise en cache (Cache-Control, , Expires, Last-Modified``Pragmaet Vary) peuvent être supprimés lorsque le modèle objet de cache est utilisé. Ce comportement permet ASP.NET de conserver les paramètres les plus restrictifs. Prenons l’exemple d’une page qui inclut des contrôles utilisateur. Si ces contrôles ont des stratégies de cache en conflit, la stratégie de cache la plus restrictive sera utilisée. Si un contrôle utilisateur définit l’en-tête «Cache-Control: Public » et un autre contrôle utilisateur définit l’en-tête plus restrictif «Cache-Control: Private » via les appels à SetCacheability, l’en-tête «Cache-Control: Private » est envoyé avec la réponse.

Pour obtenir la liste des en-têtes HTTP/1.1 standard, consultez les définitions des champs d’en-tête.