HttpListenerResponse.AddHeader(String, String) Método

Referencia

Definición

Espacio de nombres:: System.Net

Ensamblados:: netstandard.dll, System.Net.HttpListener.dll

Ensamblado:: System.Net.HttpListener.dll

Ensamblado:: System.dll

Ensamblado:: netstandard.dll

Source:: HttpListenerResponse.cs

Source:: HttpListenerResponse.cs

Source:: HttpListenerResponse.cs

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

Se aplica a

Producto	Versiones
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

Compartir a través de