WebHeaderCollection.AddWithoutValidate(String, String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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 -> unitProtected Sub AddWithoutValidate (headerName As String, headerValue As String)Parâmetros
- headerName
- String
O cabeçalho para adicionar à coleção.
- headerValue
- String
O conteúdo do cabeçalho.
Exceções
headerName é null, Empty, ou contém caracteres inválidos.
-ou-
headerValue contém caracteres inválidos.
.NET Framework e .NET Core apenas: headerName não é null e o comprimento de headerValue é demasiado longo (superior a 65.535 caracteres).
Observações
O AddWithoutValidate método adiciona um cabeçalho à coleção sem verificar se o cabeçalho está na lista de cabeçalhos restritos.
Note
O comprimento de headerValue é validado apenas no .NET Framework e .NET versões Core 2.0 - 3.1.
- Em todas as versões aplicáveis do .NET Framework: Uma instância WebHeaderCollection devolvida pela propriedade Headers gerará um ArgumentOutOfRangeException se o comprimento de
headerValuefor superior a 65535. Todas as outras WebHeaderCollection instâncias aceitam aheaderValuede qualquer comprimento. - Nas versões .NET Core até à versão 3.1: Uma instância WebHeaderCollection usada com qualquer cabeçalho do tipo HttpResponseHeader gerará um ArgumentOutOfRangeException se o comprimento de
headerValuefor superior a 65535. Todas as outras WebHeaderCollection instâncias aceitam aheaderValuede qualquer comprimento. - No .NET 5 e versões posteriores: WebHeaderCollection aceita um
headerValuede qualquer comprimento.
Notas para Herdeiros
Use o AddWithoutValidate(String, String) método para adicionar cabeçalhos que normalmente são expostos através das propriedades.