WebHeaderCollection.AddWithoutValidate(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í.
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);
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
headerName
es null
, Empty o contiene caracteres no válidos.
o bien
headerValue
contiene caracteres no válidos.
.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á un ArgumentOutOfRangeException si la longitud de
headerValue
es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan unaheaderValue
longitud de cualquier longitud. - En las versiones de .NET Core a la versión 3.1: una WebHeaderCollection instancia usada con cualquier encabezado de tipo HttpResponseHeader producirá si ArgumentOutOfRangeException la longitud de
headerValue
es mayor que 65535. Todas las demás WebHeaderCollection instancias aceptan unaheaderValue
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.