CA2024: Não use StreamReader.EndOfStream em métodos assíncronos

Artigo
01/17/2025

Propriedade	Valor
ID da regra	CA2024
Título	Não use StreamReader.EndOfStream em métodos assíncronos
Categoria	Fiabilidade
correção está quebrando ou não quebrando	Sem quebra
Ativado por padrão no .NET 10	Como aviso

Causa

Uma chamada para StreamReader.EndOfStream é feita dentro de um método assíncrono.

Descrição da regra

A propriedade StreamReader.EndOfStream pode causar bloqueio síncrono não intencional quando nenhum dado é armazenado em buffer. Em vez disso, use StreamReader.ReadLineAsync() diretamente, que retorna null ao chegar ao final do fluxo.

Como corrigir violações

Para corrigir uma violação, ligue diretamente para StreamReader.ReadLineAsync() e verifique o valor de retorno para null.

Exemplo

O trecho de código a seguir mostra uma violação do CA2024:

public async Task Example(StreamReader streamReader)
{
    while (!streamReader.EndOfStream)
    {
        string? line = await streamReader.ReadLineAsync();
        // Do something with line.
    }
}

Public Async Function Example(streamReader As StreamReader) As Task
    While Not streamReader.EndOfStream
        Dim line As String = Await streamReader.ReadLineAsync()
        ' Do something with line.
    End While
End Function

O trecho de código a seguir corrige a violação:

public async Task Example(StreamReader streamReader)
{
    string? line;
    while ((line = await streamReader.ReadLineAsync()) is not null)
    {
        // Do something with line.
    }
}

Public Async Function Example(streamReader As StreamReader) As Task
    Dim line As String = Await streamReader.ReadLineAsync()
    While line IsNot Nothing
        ' Do something with line.
        line = Await streamReader.ReadLineAsync()
    End While
End Function

Quando suprimir avisos

Você não deve suprimir avisos dessa regra, pois seu aplicativo pode travar se você não corrigir as violações.

Suprimir um aviso

Se você quiser apenas suprimir uma única violação, adicione diretivas de pré-processador ao seu arquivo de origem para desativar e, em seguida, reativar a regra.

#pragma warning disable CA2024
// The code that's violating the rule is on this line.
#pragma warning restore CA2024

Para desabilitar a regra para um arquivo, pasta ou projeto, defina sua gravidade como none no arquivo de configuração .

[*.{cs,vb}]
dotnet_diagnostic.CA2024.severity = none

Para obter mais informações, consulte Como suprimir avisos de análise de código.

Partilhar via