BC42358: Como essa chamada não é esperada, a execução do método atual continua antes que a chamada seja concluída

Como essa chamada não é esperada, a execução do método atual continua antes que a chamada seja concluída. Considere aplicar o Await operador ao resultado da chamada.

O método atual chama um método assíncrono que retorna a Task ou a Task<TResult> e não aplica o operador Await ao resultado. A chamada para o método assíncrono inicia uma tarefa assíncrona. No entanto, como nenhum Await operador é aplicado, o programa continua sem esperar que a tarefa seja concluída. Na maioria dos casos, esse comportamento não é esperado. Normalmente, outros aspetos do método de chamada dependem dos resultados da chamada ou, minimamente, espera-se que o método chamado seja concluído antes que você retorne do método que contém a chamada.

Uma questão igualmente importante é o que acontece com as exceções que são levantadas no chamado método assíncrono. Uma exceção que é gerada em um método que retorna um Task ou Task<TResult> é armazenado na tarefa retornada. Se você não aguardar a tarefa ou verificar explicitamente se há exceções, a exceção será perdida. Se você aguardar a tarefa, sua exceção será relançada.

Como prática recomendada, você deve sempre aguardar a chamada.

Por padrão, essa mensagem é um aviso. Para obter mais informações sobre como ocultar avisos ou tratar avisos como erros, consulte Configurando avisos no Visual Basic.

ID de erro: BC42358

Para responder a este aviso

Você deve considerar suprimir o aviso somente se tiver certeza de que não deseja esperar a conclusão da chamada assíncrona e que o método chamado não gerará exceções. Nesse caso, você pode suprimir o aviso atribuindo o resultado da tarefa da chamada a uma variável.

O exemplo a seguir mostra como causar o aviso, como suprimi-lo e como aguardar a chamada:

Async Function CallingMethodAsync() As Task

    ResultsTextBox.Text &= vbCrLf & "  Entering calling method."

    ' Variable delay is used to slow down the called method so that you
    ' can distinguish between awaiting and not awaiting in the program's output.
    ' You can adjust the value to produce the output that this topic shows
    ' after the code.
    Dim delay = 5000

    ' Call #1.
    ' Call an async method. Because you don't await it, its completion isn't
    ' coordinated with the current method, CallingMethodAsync.
    ' The following line causes the warning.
    CalledMethodAsync(delay)

    ' Call #2.
    ' To suppress the warning without awaiting, you can assign the
    ' returned task to a variable. The assignment doesn't change how
    ' the program runs. However, the recommended practice is always to
    ' await a call to an async method.
    ' Replace Call #1 with the following line.
    'Task delayTask = CalledMethodAsync(delay)

    ' Call #3
    ' To contrast with an awaited call, replace the unawaited call
    ' (Call #1 or Call #2) with the following awaited call. The best
    ' practice is to await the call.

    'Await CalledMethodAsync(delay)

    ' If the call to CalledMethodAsync isn't awaited, CallingMethodAsync
    ' continues to run and, in this example, finishes its work and returns
    ' to its caller.
    ResultsTextBox.Text &= vbCrLf & "  Returning from calling method."
End Function

Async Function CalledMethodAsync(howLong As Integer) As Task

    ResultsTextBox.Text &= vbCrLf & "    Entering called method, starting and awaiting Task.Delay."
    ' Slow the process down a little so you can distinguish between awaiting
    ' and not awaiting. Adjust the value for howLong if necessary.
    Await Task.Delay(howLong)
    ResultsTextBox.Text &= vbCrLf & "    Task.Delay is finished--returning from called method."
End Function

No exemplo, se você escolher Chamada #1 ou Chamada #2, o método assíncrono não esperado (CalledMethodAsync) será concluído após a conclusão do chamador (CallingMethodAsync) e do chamador (StartButton_Click). A última linha na saída a seguir mostra quando o método chamado termina. A entrada e saída do manipulador de eventos que chama CallingMethodAsync o exemplo completo são marcadas na saída.

Entering the Click event handler.
  Entering calling method.
    Entering called method, starting and awaiting Task.Delay.
  Returning from calling method.
Exiting the Click event handler.
    Task.Delay is finished--returning from called method.

Exemplo

O seguinte aplicativo Windows Presentation Foundation (WPF) contém os métodos do exemplo anterior. As seguintes etapas configuram o aplicativo:

1. Crie um aplicativo WPF e nomeie-o AsyncWarning.

2. No Editor de Códigos do Visual Studio, escolha a guia MainWindow.xaml .

   Se a guia não estiver visível, abra o menu de atalho para MainWindow.xaml no Gerenciador de Soluções e escolha View Code.

3. Substitua o código no modo de exibição XAML de MainWindow.xaml pelo seguinte código:

   <Window x:Class="MainWindow"
           xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
           xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
           Title="MainWindow" Height="350" Width="525">
       <Grid>
           <Button x:Name="StartButton" Content="Start" HorizontalAlignment="Left" Margin="214,28,0,0" VerticalAlignment="Top" Width="75" HorizontalContentAlignment="Center" FontWeight="Bold" FontFamily="Aharoni" Click="StartButton_Click" />
           <TextBox x:Name="ResultsTextBox" Margin="0,80,0,0" TextWrapping="Wrap" FontFamily="Lucida Console"/>
       </Grid>
   </Window>
   

   Uma janela simples que contém um botão e uma caixa de texto aparece no modo Design de MainWindow.xaml.

   Para obter mais informações sobre o Designer XAML, consulte Criando uma interface do usuário usando o Designer XAML. Para obter informações sobre como criar sua própria interface do usuário simples, consulte as seções "Para criar um aplicativo WPF" e "Para criar uma janela principal WPF simples" de Passo a passo: acessando a Web usando Async e Await.

4. Substitua o código no MainWindow.xaml.vb pelo código a seguir.

   Class MainWindow
   
       Private Async Sub StartButton_Click(sender As Object, e As RoutedEventArgs)
   
           ResultsTextBox.Text &= vbCrLf & "Entering the Click event handler."
           Await CallingMethodAsync()
           ResultsTextBox.Text &= vbCrLf & "Exiting the Click event handler."
       End Sub
   
       Async Function CallingMethodAsync() As Task
   
           ResultsTextBox.Text &= vbCrLf & "  Entering calling method."
   
           ' Variable delay is used to slow down the called method so that you
           ' can distinguish between awaiting and not awaiting in the program's output.
           ' You can adjust the value to produce the output that this topic shows
           ' after the code.
           Dim delay = 5000
   
           ' Call #1.
           ' Call an async method. Because you don't await it, its completion isn't
           ' coordinated with the current method, CallingMethodAsync.
           ' The following line causes the warning.
           CalledMethodAsync(delay)
   
           ' Call #2.
           ' To suppress the warning without awaiting, you can assign the
           ' returned task to a variable. The assignment doesn't change how
           ' the program runs. However, the recommended practice is always to
           ' await a call to an async method.
   
           ' Replace Call #1 with the following line.
           'Task delayTask = CalledMethodAsync(delay)
   
           ' Call #3
           ' To contrast with an awaited call, replace the unawaited call
           ' (Call #1 or Call #2) with the following awaited call. The best
           ' practice is to await the call.
   
           'Await CalledMethodAsync(delay)
   
           ' If the call to CalledMethodAsync isn't awaited, CallingMethodAsync
           ' continues to run and, in this example, finishes its work and returns
           ' to its caller.
           ResultsTextBox.Text &= vbCrLf & "  Returning from calling method."
       End Function
   
       Async Function CalledMethodAsync(howLong As Integer) As Task
   
           ResultsTextBox.Text &= vbCrLf & "    Entering called method, starting and awaiting Task.Delay."
           ' Slow the process down a little so you can distinguish between awaiting
           ' and not awaiting. Adjust the value for howLong if necessary.
           Await Task.Delay(howLong)
           ResultsTextBox.Text &= vbCrLf & "    Task.Delay is finished--returning from called method."
       End Function
   
   End Class
   
   ' Output
   
   ' Entering the Click event handler.
   '   Entering calling method.
   '     Entering called method, starting and awaiting Task.Delay.
   '   Returning from calling method.
   ' Exiting the Click event handler.
   '     Task.Delay is finished--returning from called method.
   
   ' Output
   
   ' Entering the Click event handler.
   '   Entering calling method.
   '     Entering called method, starting and awaiting Task.Delay.
   '     Task.Delay is finished--returning from called method.
   '   Returning from calling method.
   ' Exiting the Click event handler.
   

5. Escolha a tecla F5 para executar o programa e, em seguida, escolha o botão Iniciar .

   A saída esperada aparece no final do código.

Consulte também

• Operador Await
• Programação assíncrona com Async e Await