OperationCanceledException Construtores

Definição

Namespace:

System

Assembly:

System.Runtime.dll

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

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

public:
 OperationCanceledException();

public OperationCanceledException ();

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, 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

• Exception
• Manipulando e lançando exceções

OperationCanceledException(String)

Origem:

OperationCanceledException.cs

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

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

public OperationCanceledException (string? message);

new OperationCanceledException : string -> OperationCanceledException

Public Sub New (message As String)

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

• Exception
• Manipulando e lançando exceções

OperationCanceledException(CancellationToken)

Origem:

OperationCanceledException.cs

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

public:
 OperationCanceledException(System::Threading::CancellationToken token);

public OperationCanceledException (System.Threading.CancellationToken token);

new OperationCanceledException : System.Threading.CancellationToken -> OperationCanceledException

Public Sub New (token As CancellationToken)

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

• Exception
• Manipulando e lançando exceções

OperationCanceledException(SerializationInfo, StreamingContext)

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.

protected:
 OperationCanceledException(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 OperationCanceledException (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 OperationCanceledException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> OperationCanceledException

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

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

ObsoleteAttribute

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

• Serialização XML e SOAP

OperationCanceledException(String, Exception)

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.

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

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

new OperationCanceledException : string * Exception -> OperationCanceledException

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

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

• Exception
• Manipulando e lançando exceções

OperationCanceledException(String, CancellationToken)

Origem:

OperationCanceledException.cs

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

public:
 OperationCanceledException(System::String ^ message, System::Threading::CancellationToken token);

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

new OperationCanceledException : string * System.Threading.CancellationToken -> OperationCanceledException

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

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

• Exception
• Manipulando e lançando exceções

OperationCanceledException(String, Exception, CancellationToken)

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.

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

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

new OperationCanceledException : string * Exception * System.Threading.CancellationToken -> OperationCanceledException

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

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

• Exception
• Manipulando e lançando exceções