HttpResponse.AppendHeader(String, String) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic 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
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.