RuntimeWrappedException Classe

Definizione

Esegue l'incapsulamento di un'eccezione che non deriva dalla classe Exception.Wraps an exception that does not derive from the Exception class. La classe non può essere ereditata.This class cannot be inherited.

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à
RuntimeWrappedException
Attributi

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come generare un String oggetto come eccezione in C++ e come intercettarlo utilizzando un RuntimeWrappedException oggetto.The following code example demonstrates how to throw a String object as an exception in C++ and catch it using a RuntimeWrappedException object.

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.Some languages, such as C++, allow you to throw exceptions of any managed type. Altri linguaggi, ad esempio Microsoft C# e Visual Basic, richiedono che tutte le eccezioni generate vengano derivate dalla Exception classe.Other languages, such as Microsoft C# and Visual Basic, require that every thrown exception be derived from the Exception class. Per mantenere la compatibilità tra i linguaggi, il Common Language Runtime (CLR) esegue il wrapping degli oggetti che non derivano da Exception in un RuntimeWrappedException oggetto.To maintain compatibility between languages, the common language runtime (CLR) wraps objects that do not derive from Exception in a RuntimeWrappedException object.

È possibile utilizzare la RuntimeCompatibilityAttribute classe per specificare se le eccezioni devono comparire nel blocco catch e nei filtri eccezioni per un assembly.You can use the RuntimeCompatibilityAttribute class to specify whether exceptions should appear wrapped inside catch blocks and exception filters for an assembly. Molti compilatori di linguaggio, inclusi i compilatori Microsoft C# e Visual Basic, applicano questo attributo per impostazione predefinita per specificare il comportamento di ritorno a capo.Many language compilers, including the Microsoft C# and Visual Basic compilers, apply this attribute by default to specify the wrapping behavior.

Si noti che il runtime esegue comunque il wrapping delle eccezioni anche se si usa la RuntimeCompatibilityAttribute classe per specificare che non si vuole che vengano incapsulate.Note that the runtime still wraps exceptions even if you use the RuntimeCompatibilityAttribute class to specify that you do not want them wrapped. In questo caso, le eccezioni vengono decrittografate solo all'interno di blocchi catch o filtri eccezioni.In this case, exceptions are unwrapped only inside catch blocks or exception filters.

Costruttori

RuntimeWrappedException(Object)

Inizializza una nuova istanza della classe RuntimeWrappedException contenente l'oggetto eccezione interna.Initializes a new instance of the RuntimeWrappedException that contains the inner exception object.

Proprietà

Data

Ottiene una raccolta di coppie chiave/valore che forniscono informazioni definite dall'utente aggiuntive sull'eccezione.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Ereditato da Exception)
HelpLink

Ottiene o imposta un collegamento al file della Guida associato all'eccezione.Gets or sets a link to the help file associated with this exception.

(Ereditato da Exception)
HResult

Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Ereditato da Exception)
InnerException

Ottiene l'istanza di Exception che ha causato l'eccezione corrente.Gets the Exception instance that caused the current exception.

(Ereditato da Exception)
Message

Ottiene un messaggio che descrive l'eccezione corrente.Gets a message that describes the current exception.

(Ereditato da Exception)
Source

Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore.Gets or sets the name of the application or the object that causes the error.

(Ereditato da Exception)
StackTrace

Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate.Gets a string representation of the immediate frames on the call stack.

(Ereditato da Exception)
TargetSite

Ottiene il metodo che genera l'eccezione corrente.Gets the method that throws the current exception.

(Ereditato da Exception)
WrappedException

Ottiene l'oggetto incapsulato dall'oggetto RuntimeWrappedException.Gets the object that was wrapped by the RuntimeWrappedException object.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(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.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Ereditato da Exception)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)

Imposta l'oggetto SerializationInfo con le informazioni sull'eccezione.Sets the SerializationInfo object with information about the exception.

GetType()

Ottiene il tipo di runtime dell'istanza corrente.Gets the runtime type of the current instance.

(Ereditato da Exception)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Crea e restituisce una rappresentazione di stringa dell'eccezione corrente.Creates and returns a string representation of the current exception.

(Ereditato da Exception)

Eventi

SerializeObjectState

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Ereditato da Exception)

Si applica a