HttpListenerResponse.AddHeader(String, String) Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.HttpListener.dll

Source:

HttpListenerResponse.cs

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

Public 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

ArgumentNullException

name es null o una cadena vacía ("").

ArgumentException

No tiene permiso para especificar un valor para el encabezado especificado.

o bien

name o value contienen caracteres no válidos.

ArgumentOutOfRangeException

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

Consulte también

• HttpListener
• HttpListenerContext
• HttpListenerRequest
• WebHeaderCollection