WebHeaderCollection.AddWithoutValidate(String, String) Método

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.WebHeaderCollection.dll

Source:

WebHeaderCollection.cs

Inserta un encabezado en la colección sin comprobar si se encuentra en la lista de encabezados restringidos.

protected:
 void AddWithoutValidate(System::String ^ headerName, System::String ^ headerValue);

protected void AddWithoutValidate (string headerName, string? headerValue);

member this.AddWithoutValidate : string * string -> unit

Protected Sub AddWithoutValidate (headerName As String, headerValue As String)

Parámetros

headerName

String

Encabezado que se agrega a la colección.

headerValue

String

El contenido del encabezado.

Excepciones

ArgumentException

headerName es null, Empty o contiene caracteres no válidos.

o bien

headerValue contiene caracteres no válidos.

ArgumentOutOfRangeException

.NET Framework y .NET Core únicamente: headerName no es null y la longitud de headerValue es demasiado larga (más de 65 535 caracteres).

Comentarios

El AddWithoutValidate método agrega un encabezado a la colección sin comprobar si el encabezado está en la lista de encabezados restringidos.

Nota

La longitud de headerValue solo se valida en .NET Framework y .NET Core versiones 2.0 - 3.1.

• En todas las versiones de .NET Framework aplicables: una WebHeaderCollection instancia devuelta por la Headers propiedad producirá una ArgumentOutOfRangeException excepción si la longitud de headerValue es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan una headerValue longitud de cualquier longitud.
• En las versiones de .NET Core a través de la versión 3.1: una WebHeaderCollection instancia usada con cualquier encabezado de tipo HttpResponseHeader producirá una ArgumentOutOfRangeException excepción si la longitud de headerValue es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan una headerValue longitud de cualquier longitud.
• En .NET 5 y versiones posteriores: WebHeaderCollection acepta una headerValue longitud de cualquier longitud.

Notas a los desarrolladores de herederos

Use el AddWithoutValidate(String, String) método para agregar encabezados que normalmente se exponen a través de propiedades.