<Elemento ThrowUnobservedTaskExceptions>

Artigo
07/07/2023

Especifica se as exceções de tarefa não processadas devem terminar um processo em execução.

<configuração>
<runtime>
<ThrowUnobservedTaskExceptions>

Sintaxe

<ThrowUnobservedTaskExceptions  
   enabled="true|false"/>

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo	Descrição
`enabled`	Atributo obrigatório. Especifica se as exceções de tarefa não processadas devem terminar o processo em execução.

Atributo ativado

Valor	Descrição
`false`	Não termina o processo de execução de uma exceção de tarefa não processada. Esta é a predefinição.
`true`	Termina o processo de execução de uma exceção de tarefa não processada.

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento	Descrição
`configuration`	O elemento raiz em todos os ficheiros de configuração utilizados pelo runtime de idioma comum e .NET Framework aplicações.
`runtime`	Contém informações sobre as opções de inicialização do runtime.

Observações

Se não tiver sido observada uma exceção associada a uma Task , não existirá nenhuma Wait operação, o elemento principal não está anexado e a Task.Exception propriedade não foi lida, a exceção da tarefa é considerada como não observada.

No .NET Framework 4, por predefinição, se uma Task exceção que tem uma exceção não observada for recolhida, o finalizador lança uma exceção e termina o processo. A cessação do processo é determinada pela temporização da recolha e finalização da memória.

Para facilitar aos programadores a escrita de código assíncrono com base em tarefas, o .NET Framework 4.5 altera este comportamento predefinido para exceções não observadas. As exceções não observadas continuam a fazer com que o UnobservedTaskException evento seja gerado, mas, por predefinição, o processo não termina. Em vez disso, a exceção é ignorada após o evento ser gerado, independentemente de um processador de eventos observar a exceção.

No .NET Framework 4.5, pode utilizar o <elemento ThrowUnobservedTaskExceptions> num ficheiro de configuração de aplicação para ativar o comportamento .NET Framework 4 de gerar uma exceção.

Também pode especificar o comportamento da exceção de uma das seguintes formas:

Ao definir a variável COMPlus_ThrowUnobservedTaskExceptions de ambiente (set COMPlus_ThrowUnobservedTaskExceptions=1).
Ao definir o valor DWORD do registo ThrowUnobservedTaskExceptions = 1 na chave de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework.

Exemplo 1

O exemplo seguinte mostra como ativar o lançamento de exceções em tarefas através de um ficheiro de configuração de aplicação.

<configuration>
    <runtime>
        <ThrowUnobservedTaskExceptions enabled="true"/>
    </runtime>
</configuration>

Exemplo 2

O exemplo seguinte demonstra como uma exceção não observada é emitida a partir de uma tarefa. O código tem de ser executado como um programa lançado para funcionar corretamente.

using System;
using System.Threading;
using System.Collections.Generic;
using System.Threading.Tasks;

//Use the following config settings to enable the throwing of unobserved exceptions.
//    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
//    <ThrowUnobservedTaskExceptions enabled="true"/>

public class Example
{
    static void Main()
    {
        Task.Run(() => { throw new InvalidOperationException("test"); });
        while (true)
        {
            Thread.Sleep(100);
            GC.Collect();
            GC.WaitForPendingFinalizers();
        }
    }
}

Imports System.Threading
Imports System.Threading.Tasks

'Use the following config settings to enable the throwing of unobserved exceptions.
'    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
'    <ThrowUnobservedTaskExceptions enabled="true"/>

Public Class Example
    Shared Sub Main()
        Task.Run(Sub() Throw New InvalidOperationException("test"))
        Do
            Thread.Sleep(100)
            GC.Collect()
            GC.WaitForPendingFinalizers()
        Loop
    End Sub
End Class

Partilhar via