HttpResponse.AppendHeader(String, String) Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Agrega un encabezado HTTP al flujo de salida.

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)

Parámetros

name

String

Nombre del encabezado HTTP que se agregará al flujo de salida.

value

String

Cadena que se agregará al encabezado.

Excepciones

HttpException

El encabezado se agrega cuando se han enviado los encabezados HTTP.

Ejemplos

En el ejemplo siguiente se llama al AppendHeader método para agregar un encabezado personalizado al HttpResponse objeto enviado al cliente solicitante.

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

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

Comentarios

Si usa el AppendHeader método para enviar encabezados específicos de la caché y, al mismo tiempo, usa el modelo de objetos de caché (Cache) para establecer la directiva de caché, los encabezados de respuesta HTTP que pertenecen al almacenamiento en caché (Cache-Control, Expires, Last-Modified, Pragmay Vary) se pueden eliminar cuando se usa el modelo de objetos de caché. Este comportamiento permite a ASP.NET mantener la configuración más restrictiva. Por ejemplo, considere una página que incluya controles de usuario. Si esos controles tienen directivas de caché en conflicto, se usará la directiva de caché más restrictiva. Si un control de usuario establece el encabezado "Cache-Control: Public" y otro control de usuario establece el encabezado más restrictivo "Cache-Control: Private" mediante llamadas a SetCacheability, el encabezado "Cache-Control: Private" se enviará con la respuesta.

Para obtener una lista de encabezados HTTP/1.1 estándar, vea Definiciones de campo de encabezado.