RuntimeWrappedException Classe

Definição

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
RuntimeWrappedException
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)

Aplica-se a