RuntimeWrappedException Classe

Definizione

Spazio dei nomi:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Esegue l'incapsulamento di un'eccezione che non deriva dalla classe Exception. La classe non può essere ereditata.

public ref class RuntimeWrappedException sealed : Exception

public sealed class RuntimeWrappedException : Exception

[System.Serializable]
public sealed class RuntimeWrappedException : Exception

type RuntimeWrappedException = class
    inherit Exception

[<System.Serializable>]
type RuntimeWrappedException = class
    inherit Exception

Public NotInheritable Class RuntimeWrappedException
Inherits Exception

Ereditarietà

Object

Exception

RuntimeWrappedException

Attributi

SerializableAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come generare un String oggetto come eccezione in C++ e intercettarlo usando un RuntimeWrappedException oggetto .

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;
}

Commenti

Alcuni linguaggi, ad esempio C++, consentono di generare eccezioni di qualsiasi tipo gestito. Altri linguaggi, ad esempio Microsoft C# e Visual Basic, richiedono che ogni eccezione generata sia derivata dalla Exception classe . Per mantenere la compatibilità tra i linguaggi, Common Language Runtime (CLR) esegue il wrapping di oggetti che non derivano da Exception in un RuntimeWrappedException oggetto .

È possibile usare la RuntimeCompatibilityAttribute classe per specificare se le eccezioni devono essere incluse all'interno di blocchi catch e filtri di eccezione per un assembly. Molti compilatori del linguaggio, inclusi Microsoft C# e Visual Basic compilatori, applicano questo attributo per impostazione predefinita per specificare il comportamento di wrapping.

Si noti che il runtime esegue comunque il wrapping delle eccezioni anche se si usa la classe per specificare che non si vuole eseguirne il RuntimeCompatibilityAttribute wrapping. In questo caso, le eccezioni vengono annullate solo all'interno di blocchi catch o filtri di eccezione.

Costruttori

RuntimeWrappedException(Object)

Inizializza una nuova istanza della classe RuntimeWrappedException contenente l'oggetto eccezione interna.

Proprietà

Data	Ottiene una raccolta di coppie chiave/valore che forniscono informazioni definite dall'utente aggiuntive sull'eccezione. (Ereditato da Exception)
HelpLink	Ottiene o imposta un collegamento al file della Guida associato all'eccezione. (Ereditato da Exception)
HResult	Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica. (Ereditato da Exception)
InnerException	Ottiene l'istanza di Exception che ha causato l'eccezione corrente. (Ereditato da Exception)
Message	Ottiene un messaggio che descrive l'eccezione corrente. (Ereditato da Exception)
Source	Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore. (Ereditato da Exception)
StackTrace	Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate. (Ereditato da Exception)
TargetSite	Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception)
WrappedException	Ottiene l'oggetto incapsulato dall'oggetto RuntimeWrappedException.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBaseException()	Quando ne viene eseguito l'override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive. (Ereditato da Exception)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)	Imposta l'oggetto SerializationInfo con le informazioni sull'eccezione.
GetType()	Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Crea e restituisce una rappresentazione di stringa dell'eccezione corrente. (Ereditato da Exception)

Eventi

SerializeObjectState

Obsoleta. Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione. (Ereditato da Exception)