TaskCanceledException Construtores

Definição

Namespace:

System.Threading.Tasks

Assemblies:

netstandard.dll, System.Runtime.dll

Inicializa uma nova instância da classe TaskCanceledException.

Sobrecargas

Nome	Description
TaskCanceledException()	Inicializa uma nova instância da classe TaskCanceledException com uma mensagem fornecida pelo sistema que descreve o erro.
TaskCanceledException(String)	Inicializa uma nova instância da classe TaskCanceledException com uma mensagem especificada que descreve o erro.
TaskCanceledException(Task)	Inicializa uma nova instância da TaskCanceledException classe com uma referência à Task que foi cancelada.
TaskCanceledException(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da TaskCanceledException classe com dados serializados.
TaskCanceledException(String, Exception)	Inicializa uma nova instância da TaskCanceledException classe com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa exceção.
TaskCanceledException(String, Exception, CancellationToken)	Inicializa uma nova instância da TaskCanceledException classe com uma mensagem de erro especificada, uma referência à exceção interna que é a causa dessa exceção e a CancellationToken que disparou o cancelamento.

TaskCanceledException()

Origem:

TaskCanceledException.cs

Inicializa uma nova instância da classe TaskCanceledException com uma mensagem fornecida pelo sistema que descreve o erro.

public:
 TaskCanceledException();

public TaskCanceledException();

Public Sub New ()

Comentários

Esse construtor inicializa a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro. Essa mensagem leva em conta a cultura atual do sistema.

A tabela a seguir mostra os valores de propriedade iniciais para uma instância de OperationCanceledException:

Propriedade	Valor
InnerException	null.
Message	A cadeia de caracteres de mensagem de erro localizada.

Confira também

• Manipulando e lançando exceções
• Programação assíncrona baseada em tarefa
• Cancelamento de Tarefa
• Como: cancelar uma tarefa e seus filhos

TaskCanceledException(String)

Origem:

TaskCanceledException.cs

Inicializa uma nova instância da classe TaskCanceledException com uma mensagem especificada que descreve o erro.

public:
 TaskCanceledException(System::String ^ message);

public TaskCanceledException(string? message);

new System.Threading.Tasks.TaskCanceledException : string -> System.Threading.Tasks.TaskCanceledException

Public Sub New (message As String)

Parâmetros

message

String

A mensagem que descreve a exceção. O chamador desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura atual do sistema.

Comentários

A tabela a seguir mostra os valores de propriedade iniciais de uma instância de TaskCanceledException.

Propriedade	Valor
InnerException	null.
Message	A cadeia de caracteres de mensagem de erro especificada em message.

Confira também

• Manipulando e lançando exceções
• Programação assíncrona baseada em tarefa
• Cancelamento de Tarefa
• Como: cancelar uma tarefa e seus filhos

TaskCanceledException(Task)

Origem:

TaskCanceledException.cs

Inicializa uma nova instância da TaskCanceledException classe com uma referência à Task que foi cancelada.

public:
 TaskCanceledException(System::Threading::Tasks::Task ^ task);

public TaskCanceledException(System.Threading.Tasks.Task? task);

new System.Threading.Tasks.TaskCanceledException : System.Threading.Tasks.Task -> System.Threading.Tasks.TaskCanceledException

Public Sub New (task As Task)

Parâmetros

task

Task

Uma tarefa que foi cancelada.

Confira também

• Manipulando e lançando exceções
• Programação assíncrona baseada em tarefa
• Cancelamento de Tarefa
• Como: cancelar uma tarefa e seus filhos

TaskCanceledException(SerializationInfo, StreamingContext)

Origem:

TaskCanceledException.cs

Cuidado

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma nova instância da TaskCanceledException classe com dados serializados.

protected:
 TaskCanceledException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected TaskCanceledException(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Threading.Tasks.TaskCanceledException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Threading.Tasks.TaskCanceledException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info

SerializationInfo

O objeto que contém os dados do objeto serializado.

context

StreamingContext

As informações contextuais sobre a origem ou o destino.

Atributos

ObsoleteAttribute

Comentários

Esse construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido por um fluxo. Para obter mais informações, consulte de serialização XML e SOAP.

Confira também

• Manipulando e lançando exceções
• Programação assíncrona baseada em tarefa
• Cancelamento de Tarefa
• Como: cancelar uma tarefa e seus filhos
• Serialização XML e SOAP

TaskCanceledException(String, Exception)

Origem:

TaskCanceledException.cs

Inicializa uma nova instância da TaskCanceledException classe com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa exceção.

public:
 TaskCanceledException(System::String ^ message, Exception ^ innerException);

public TaskCanceledException(string? message, Exception? innerException);

new System.Threading.Tasks.TaskCanceledException : string * Exception -> System.Threading.Tasks.TaskCanceledException

Public Sub New (message As String, innerException As Exception)

Parâmetros

message

String

A mensagem que descreve a exceção. O chamador desse construtor é necessário para garantir que essa cadeia de caracteres tenha sido localizada para a cultura atual do sistema.

innerException

Exception

A exceção que é a causa da exceção atual. Se o innerException parâmetro não nullfor, a exceção atual será gerada em um catch bloco que manipula a exceção interna.

Comentários

Uma exceção gerada como resultado direto de uma exceção anterior deve incluir uma referência à exceção anterior na InnerException propriedade. A InnerException propriedade retorna o mesmo valor que é passado para o construtor ou null se a InnerException propriedade não fornece o valor de exceção interna ao construtor.

A tabela a seguir mostra os valores de propriedade iniciais de uma instância de TaskCanceledException.

Propriedade	Valor
InnerException	null.
Message	A cadeia de caracteres de mensagem de erro especificada em message.

Confira também

• Manipulando e lançando exceções
• Programação assíncrona baseada em tarefa
• Cancelamento de Tarefa
• Como: cancelar uma tarefa e seus filhos

TaskCanceledException(String, Exception, CancellationToken)

Origem:

TaskCanceledException.cs

Inicializa uma nova instância da TaskCanceledException classe com uma mensagem de erro especificada, uma referência à exceção interna que é a causa dessa exceção e a CancellationToken que disparou o cancelamento.

public:
 TaskCanceledException(System::String ^ message, Exception ^ innerException, System::Threading::CancellationToken token);

public TaskCanceledException(string? message, Exception? innerException, System.Threading.CancellationToken token);

new System.Threading.Tasks.TaskCanceledException : string * Exception * System.Threading.CancellationToken -> System.Threading.Tasks.TaskCanceledException

Public Sub New (message As String, innerException As Exception, token As CancellationToken)

Parâmetros

message

String

A mensagem de erro que explica o motivo da exceção.

innerException

Exception

A exceção que é a causa da exceção atual.

token

CancellationToken

O token de cancelamento que disparou o cancelamento.