Compartilhar via


CA2262: Definir 'MaxResponseHeadersLength' corretamente

Propriedade Valor
ID da regra CA2262
Título Definir MaxResponseHeadersLength corretamente
Categoria Usage
Correção interruptiva ou sem interrupção Sem interrupção
Habilitado por padrão no .NET 9 Como sugestão

Causa

A propriedade HttpClientHandler.MaxResponseHeadersLength é definida com um valor maior que um 128.

Descrição da regra

A propriedade HttpClientHandler.MaxResponseHeadersLength é medida em quilobytes, não em bytes. O comprimento máximo padrão é de 64 KB, que deve ser grande o suficiente para a maioria dos casos de uso. Se você definir a propriedade para um valor maior que 128 kilobytes, pode ser devido a um mal-entendido das unidades dessa propriedade.

Como corrigir violações

Se você pretendia definir um valor menor, atualize-o para o valor desejado medido em quilobytes.

Exemplo

HttpClientHandler handler = new()
{
    // Violation
    MaxResponseHeadersLength = 512

    // Fix (it is not possible to specify a limit lower than 1 KB)
    MaxResponseHeadersLength = 1
};

Dim handler As New HttpClientHandler With {
    ' Violation
    .MaxResponseHeadersLength = 512

    ' Fix (it is not possible to specify a limit lower than 1 KB)
    .MaxResponseHeadersLength = 1
}

Quando suprimir erros

É seguro suprimir esse aviso se o valor grande for pretendido.