WebHeaderCollection.AddWithoutValidate(String, String) Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebHeaderCollection.dll

Origem:

WebHeaderCollection.cs

Insere um cabeçalho na coleção sem verificar se o cabeçalho está na lista de cabeçalhos restritos.

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

O cabeçalho a ser adicionado à coleção.

headerValue

String

O conteúdo do cabeçalho.

Exceções

ArgumentException

headerName é null, Empty ou contém caracteres inválidos.

- ou -

headerValue contém caracteres inválidos.

ArgumentOutOfRangeException

Somente .NET Framework e .NET Core: headerName não é null, e o comprimento de headerValue é muito longo (maior que 65.535 caracteres).

Comentários

O AddWithoutValidate método adiciona um cabeçalho à coleção sem verificar se o cabeçalho está na lista de cabeçalhos restritos.

Observação

O comprimento de headerValue é validado apenas no .NET Framework e no .NET Core versões 2.0 – 3.1.

• Em todas as versões aplicáveis do .NET Framework: uma WebHeaderCollection instância retornada pela Headers propriedade gerará um ArgumentOutOfRangeException se o comprimento de headerValue for maior que 65535. Todas as outras WebHeaderCollection instâncias aceitam um headerValue de qualquer comprimento.
• Em versões do .NET Core até a versão 3.1: uma WebHeaderCollection instância usada com qualquer cabeçalho do tipo HttpResponseHeader gerará um ArgumentOutOfRangeException se o comprimento de headerValue for maior que 65535. Todas as outras WebHeaderCollection instâncias aceitam um headerValue de qualquer comprimento.
• No .NET 5 e versões posteriores: WebHeaderCollection aceita um headerValue de qualquer comprimento.

Notas aos Herdeiros

Use o AddWithoutValidate(String, String) método para adicionar cabeçalhos que normalmente são expostos por meio de propriedades.