RuntimeWrappedException Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Envolve uma exceção que não deriva da Exception classe. Esta classe não pode ser herdada.
public ref class RuntimeWrappedException sealed : Exception
[System.Serializable]
public sealed class RuntimeWrappedException : Exception
public sealed class RuntimeWrappedException : Exception
[<System.Serializable>]
type RuntimeWrappedException = class
inherit Exception
type RuntimeWrappedException = class
inherit Exception
Public NotInheritable Class RuntimeWrappedException
Inherits Exception
- Herança
- Atributos
Exemplos
O exemplo de código seguinte demonstra como lançar um String objeto como exceção em C++ e apanhá-lo usando um RuntimeWrappedException objeto.
using namespace System;
using namespace System::Runtime::CompilerServices;
[assembly:RuntimeCompatibilityAttribute(WrapNonExceptionThrows = true)];
void run()
{
try
{
throw gcnew String("This is a string");
}
catch(RuntimeWrappedException^ e)
{
Console::WriteLine("RuntimeWrappedException caught!");
}
}
int main()
{
run();
return 0;
}
Observações
Algumas linguagens, como o C++, permitem lançar exceções de qualquer tipo gerido. Outras linguagens, como Microsoft C# e Visual Basic, exigem que cada exceção lançada seja derivada da classe Exception. Para manter a compatibilidade entre linguagens, o tempo de execução da linguagem comum (CLR) envolve objetos que não derivam de Exception dentro de um RuntimeWrappedException objeto.
Podes usar a RuntimeCompatibilityAttribute classe para especificar se as exceções devem aparecer encapsuladas dentro de blocos de captura e filtros de exceção para uma assembleia. Muitos compiladores de linguagens, incluindo os compiladores Microsoft C# e Visual Basic, aplicam este atributo por defeito para especificar o comportamento de envolvimento.
Note que o runtime continua a envolver exceções mesmo que use a RuntimeCompatibilityAttribute classe para especificar que não quer que sejam encapsuladas. Neste caso, as exceções são desembrulhadas apenas dentro dos blocos de captura ou filtros de exceção.
Construtores
| Name | Description |
|---|---|
| RuntimeWrappedException(Object) |
Inicializa uma nova instância do RuntimeWrappedException que contém o objeto de exceção interno. |
Propriedades
| Name | Description |
|---|---|
| Data |
Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção. (Herdado de Exception) |
| HelpLink |
Obtém ou define um link para o ficheiro de ajuda associado a esta exceção. (Herdado de Exception) |
| HResult |
Recebe ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica. (Herdado de Exception) |
| InnerException |
Obtém a Exception instância que causou a exceção atual. (Herdado de Exception) |
| Message |
Recebe uma mensagem que descreve a exceção atual. (Herdado de Exception) |
| Source |
Obtém ou define o nome do aplicativo ou o objeto que causa o erro. (Herdado de Exception) |
| StackTrace |
Obtém uma representação string dos frames imediatos na stack de chamadas. (Herdado de Exception) |
| TargetSite |
Obtém o método que lança a exceção atual. (Herdado de Exception) |
| WrappedException |
Obtém o objeto que foi envolto pelo RuntimeWrappedException objeto. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBaseException() |
Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Define o SerializationInfo objeto com informação sobre a exceção. |
| GetType() |
Obtém o tipo de execução da instância atual. (Herdado de Exception) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Cria e devolve uma representação string da exceção atual. (Herdado de Exception) |
evento
| Name | Description |
|---|---|
| SerializeObjectState |
Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception) |