Ler em inglês

Compartilhar via


OperationCanceledException Construtores

Definição

Inicializa uma nova instância da classe OperationCanceledException.

Sobrecargas

OperationCanceledException()

Inicializa uma nova instância da classe OperationCanceledException com uma mensagem de erro fornecida pelo sistema.

OperationCanceledException(String)

Inicializa uma nova instância da classe OperationCanceledException com uma mensagem de erro especificada.

OperationCanceledException(CancellationToken)

Inicializa uma nova instância da classe OperationCanceledException com um token de cancelamento.

OperationCanceledException(SerializationInfo, StreamingContext)
Obsoleto.

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

OperationCanceledException(String, Exception)

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

OperationCanceledException(String, CancellationToken)

Inicializa uma nova instância da classe OperationCanceledException com uma mensagem de erro e um token de cancelamento.

OperationCanceledException(String, Exception, CancellationToken)

Inicializa uma nova instância da classe OperationCanceledException com uma mensagem de erro, uma referência à exceção interna que é a causa da exceção e um token de cancelamento especificados.

OperationCanceledException()

Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs

Inicializa uma nova instância da classe OperationCanceledException com uma mensagem de erro fornecida pelo sistema.

C#
public OperationCanceledException ();

Comentários

Esse construtor inicializa a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, como "A operação foi cancelada". Essa mensagem leva em conta a cultura atual do sistema.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de OperationCanceledException.

Propriedade Valor
InnerException Uma referência nula (Nothing no Visual Basic).
Message A cadeia de caracteres da mensagem de erro localizada.
CancellationToken Um token de cancelamento criado no estado não cancelado.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

OperationCanceledException(String)

Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs

Inicializa uma nova instância da classe OperationCanceledException com uma mensagem de erro especificada.

C#
public OperationCanceledException (string message);
C#
public OperationCanceledException (string? message);

Parâmetros

message
String

Um String que descreve o erro.

Comentários

O conteúdo de message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de OperationCanceledException.

Propriedade Valor
InnerException Uma referência nula (Nothing no Visual Basic).
Message A cadeia de caracteres da mensagem de erro.
CancellationToken Um token de cancelamento criado no estado não cancelado.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

OperationCanceledException(CancellationToken)

Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs

Inicializa uma nova instância da classe OperationCanceledException com um token de cancelamento.

C#
public OperationCanceledException (System.Threading.CancellationToken token);

Parâmetros

token
CancellationToken

Um token de cancelamento associado à operação que foi cancelada.

Comentários

Esse construtor inicializa a Message propriedade da nova instância para uma mensagem fornecida pelo sistema que descreve o erro, como "A operação foi cancelada". Essa mensagem leva em conta a cultura atual do sistema.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de OperationCanceledException.

Propriedade Valor
InnerException Uma referência nula (Nothing no Visual Basic).
Message A cadeia de caracteres da mensagem de erro localizada.
CancellationToken token.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

OperationCanceledException(SerializationInfo, StreamingContext)

Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.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 classe OperationCanceledException com dados serializados.

C#
protected OperationCanceledException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
C#
[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 OperationCanceledException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

Parâmetros

info
SerializationInfo

O objeto que mantém os dados de objeto serializados.

context
StreamingContext

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

Atributos

Comentários

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

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões (Obsoleto)
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 (8, 9)
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

OperationCanceledException(String, Exception)

Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs

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

C#
public OperationCanceledException (string message, Exception innerException);
C#
public OperationCanceledException (string? message, Exception? innerException);

Parâmetros

message
String

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

innerException
Exception

A exceção que é a causa da exceção atual. Caso o parâmetro innerException não seja null, a exceção atual é acionada em um bloco catch que identifica a exceção interna.

Comentários

O conteúdo de message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

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

A tabela a seguir mostra os valores de propriedade inicial de uma instância de OperationCanceledException.

Tipo de propriedade Condição
InnerException innerException.
Message message.
CancellationToken Um token de cancelamento criado no estado não cancelado.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

OperationCanceledException(String, CancellationToken)

Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs

Inicializa uma nova instância da classe OperationCanceledException com uma mensagem de erro e um token de cancelamento.

C#
public OperationCanceledException (string message, System.Threading.CancellationToken token);
C#
public OperationCanceledException (string? message, System.Threading.CancellationToken token);

Parâmetros

message
String

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

token
CancellationToken

Um token de cancelamento associado à operação que foi cancelada.

Comentários

O conteúdo de message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

A tabela a seguir mostra os valores de propriedade inicial de uma instância de OperationCanceledException.

Propriedade Valor
InnerException Uma referência nula (Nothing no Visual Basic).
Message message.
CancellationToken token.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

OperationCanceledException(String, Exception, CancellationToken)

Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs
Origem:
OperationCanceledException.cs

Inicializa uma nova instância da classe OperationCanceledException com uma mensagem de erro, uma referência à exceção interna que é a causa da exceção e um token de cancelamento especificados.

C#
public OperationCanceledException (string message, Exception innerException, System.Threading.CancellationToken token);
C#
public OperationCanceledException (string? message, Exception? innerException, System.Threading.CancellationToken token);

Parâmetros

message
String

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

innerException
Exception

A exceção que é a causa da exceção atual. Caso o parâmetro innerException não seja null, a exceção atual é acionada em um bloco catch que identifica a exceção interna.

token
CancellationToken

Um token de cancelamento associado à operação que foi cancelada.

Comentários

O conteúdo de message deve ser compreendido por humanos. O chamador deste construtor é obrigatório para garantir que esta cadeia de caracteres foi localizada para a cultura do sistema atual.

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

A tabela a seguir mostra os valores de propriedade inicial de uma instância de OperationCanceledException.

Tipo de propriedade Condição
InnerException innerException.
Message message.
CancellationToken token.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0