RuntimeWrappedException RuntimeWrappedException RuntimeWrappedException RuntimeWrappedException Class

Definizione

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

public ref class RuntimeWrappedException sealed : Exception
[System.Serializable]
public sealed class RuntimeWrappedException : Exception
type RuntimeWrappedException = class
    inherit Exception
Public NotInheritable Class RuntimeWrappedException
Inherits Exception
Ereditarietà
RuntimeWrappedExceptionRuntimeWrappedExceptionRuntimeWrappedExceptionRuntimeWrappedException
Attributi

Esempi

Esempio di codice seguente viene illustrato come generare una String dell'oggetto come un'eccezione in C++ e intercettarlo utilizzando una 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, è necessario che ogni eccezione generata sia derivata dal 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, common language runtime (CLR) esegue il wrapping di 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 usare il RuntimeCompatibilityAttribute classe per specificare se le eccezioni devono apparire incapsulate in blocchi catch e i 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 l'incapsulamento delle eccezioni anche se si usa il RuntimeCompatibilityAttribute classe per specificare che devono essere 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 annullato il wrapping solo all'interno di blocchi catch o i filtri eccezioni.In this case, exceptions are unwrapped only inside catch blocks or exception filters.

Costruttori

RuntimeWrappedException(Object) RuntimeWrappedException(Object) RuntimeWrappedException(Object) RuntimeWrappedException(Object)

Proprietà

Data Data Data Data

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

(Inherited from Exception)
HelpLink HelpLink HelpLink 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.

(Inherited from Exception)
HResult HResult HResult 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.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

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

(Inherited from Exception)
Message Message Message Message

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

(Inherited from Exception)
Source Source Source 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.

(Inherited from Exception)
StackTrace StackTrace StackTrace 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.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

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

(Inherited from Exception)
WrappedException WrappedException WrappedException WrappedException

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

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

Se utilizzato come metodo di 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.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

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

GetType() GetType() GetType() GetType()

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

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Exception)

Eventi

SerializeObjectState SerializeObjectState SerializeObjectState 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.

(Inherited from Exception)

Si applica a