HttpResponse.AppendHeader(String, String) HttpResponse.AppendHeader(String, String) HttpResponse.AppendHeader(String, String) HttpResponse.AppendHeader(String, String) Method

Definición

Agrega un encabezado HTTP al flujo de salida.Adds an HTTP header to the output stream.

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 String String String

Nombre del encabezado HTTP que se agregará al flujo de salida.The name of the HTTP header to add to the output stream.

value
String String String String

Cadena que se agregará al encabezado.The string to append to the header.

Excepciones

El encabezado se agrega cuando se han enviado los encabezados HTTP.The header is appended after the HTTP headers have been sent.

Ejemplos

En el ejemplo siguiente se AppendHeader llama al método para agregar un encabezado personalizado HttpResponse al objeto enviado al cliente que lo solicita.The following example calls the AppendHeader method to add a custom header to the HttpResponse object sent to the requesting client.

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

Comentarios

AppendHeader Si usa el método para enviar encabezados específicos de la memoria caché y, al mismo tiempo, use el modelo de objetosCachede caché () para establecer la Directiva de caché, los encabezados de respuesta HTTP Expiresque Last-Modifiedpertenecen al almacenamiento en caché (Cache-Control,,, Pragma, y Vary) se pueden eliminar cuando se usa el modelo de objetos de caché.If you use the AppendHeader method to send cache-specific headers and at the same time use the cache object model (Cache) to set cache policy, HTTP response headers that pertain to caching (Cache-Control, Expires, Last-Modified, Pragma, and Vary) might be deleted when the cache object model is used. Este comportamiento permite a ASP.NET mantener la configuración más restrictiva.This behavior enables ASP.NET to maintain the most restrictive settings. Por ejemplo, considere una página que incluye controles de usuario.For example, consider a page that includes user controls. Si esos controles tienen directivas de caché en conflicto, se usará la Directiva de caché más restrictiva.If those controls have conflicting cache policies, the most restrictive cache policy will be used. Si un control de usuario establece el encabezadoCache-Control: Public"" y otro control de usuario establece el encabezado más restrictivoCache-Control: Private"" mediante llamadas SetCacheabilitya, el encabezadoCache-Control: Private"" se enviará con la respuesta.If one user control sets the header "Cache-Control: Public" and another user control sets the more restrictive header "Cache-Control: Private" via calls to SetCacheability, then the "Cache-Control: Private" header will be sent with the response.

Para obtener una lista de encabezados HTTP/1.1 estándar, vea la sección 14, "definiciones de campos de encabezado", en la especificación de Protocolo de transferencia de hipertexto (http/1.1 ) en el sitio Web de World Wide Web Consortium (W3C).For a list of standard HTTP/1.1 headers, see section 14, "Header Field Definitions," in the Hypertext Transfer Protocol -- HTTP/1.1 specification on the World Wide Web Consortium (W3C) Web site.

Se aplica a