HttpListenerResponse.AddHeader(String, String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega el encabezado y valor especificados a los encabezados HTTP para esta respuesta.
public:
void AddHeader(System::String ^ name, System::String ^ value);public void AddHeader (string name, string value);member this.AddHeader : string * string -> unitPublic Sub AddHeader (name As String, value As String)Parámetros
- name
- String
El nombre del encabezado HTTP que se establece.
- value
- String
El valor del encabezado name.
Excepciones
name es null o una cadena vacía ("").
No tiene permiso para especificar un valor para el encabezado especificado.
o bien
name o value contienen caracteres no válidos.
.NET Framework y versiones 2.0-3.1 de .NET Core únicamente: la longitud de value es mayor de 65 535 caracteres.
Ejemplos
En el ejemplo de código siguiente se muestra cómo agregar un encabezado mediante esta propiedad.
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
Comentarios
Llamar a este método equivale a llamar al Set método en la colección devuelta por la Headers propiedad .
Si el encabezado especificado en name no existe, este método inserta un nuevo encabezado en la colección de la Headers propiedad. Si name está presente en la colección, este método reemplaza el valor existente por value. Para agregar un valor a un encabezado existente sin reemplazar el valor existente, use el AppendHeader método .
