RuntimeWrappedException Klasa

Definicja

Zawija wyjątek, który nie pochodzi od klasy Exception.Wraps an exception that does not derive from the Exception class. Klasa ta nie może być dziedziczona.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
Dziedziczenie
RuntimeWrappedException
Atrybuty

Przykłady

Poniższy przykład kodu demonstruje, jak zgłosić obiekt String jako wyjątek w C++ i przechwycić go przy użyciu obiektu RuntimeWrappedException.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;
}

Uwagi

Niektóre języki, takie jak C++, umożliwiają zgłaszanie wyjątków dowolnego typu zarządzanego.Some languages, such as C++, allow you to throw exceptions of any managed type. Inne języki, takie jak Microsoft C# i Visual Basic, wymagają, aby każdy zgłoszony wyjątek był pochodną klasy Exception.Other languages, such as Microsoft C# and Visual Basic, require that every thrown exception be derived from the Exception class. Aby zachować zgodność między językami, środowisko uruchomieniowe języka wspólnego (CLR) otacza obiekty, które nie pochodzą od Exception w obiekcie RuntimeWrappedException.To maintain compatibility between languages, the common language runtime (CLR) wraps objects that do not derive from Exception in a RuntimeWrappedException object.

Można użyć klasy RuntimeCompatibilityAttribute, aby określić, czy wyjątki powinny być widoczne wewnątrz bloków catch i filtrów wyjątków dla zestawu.You can use the RuntimeCompatibilityAttribute class to specify whether exceptions should appear wrapped inside catch blocks and exception filters for an assembly. Wiele kompilatorów języka, w tym kompilatorów firmy Microsoft C# i Visual Basic, Zastosuj ten atrybut domyślnie, aby określić zachowanie zawijania.Many language compilers, including the Microsoft C# and Visual Basic compilers, apply this attribute by default to specify the wrapping behavior.

Należy pamiętać, że środowisko uruchomieniowe ciągle otacza wyjątki, nawet jeśli używasz klasy RuntimeCompatibilityAttribute, aby określić, że mają być opakowane.Note that the runtime still wraps exceptions even if you use the RuntimeCompatibilityAttribute class to specify that you do not want them wrapped. W takim przypadku wyjątki są rozpakowane tylko wewnątrz bloków catch lub filtrów wyjątków.In this case, exceptions are unwrapped only inside catch blocks or exception filters.

Konstruktory

RuntimeWrappedException(Object)

Inicjuje nowe wystąpienie RuntimeWrappedException zawierającego obiekt wyjątku wewnętrznego.Initializes a new instance of the RuntimeWrappedException that contains the inner exception object.

Właściwości

Data

Pobiera kolekcję par klucz/wartość, które zawierają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Odziedziczone po Exception)
HelpLink

Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem.Gets or sets a link to the help file associated with this exception.

(Odziedziczone po Exception)
HResult

Pobiera lub ustawia wartość HRESULT, kodowane wartości liczbowe przypisane do określonego wyjątku.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Odziedziczone po Exception)
InnerException

Pobiera wystąpienie Exception, które spowodowało wyjątek bieżący.Gets the Exception instance that caused the current exception.

(Odziedziczone po Exception)
Message

Pobiera komunikat, który opisuje bieżący wyjątek.Gets a message that describes the current exception.

(Odziedziczone po Exception)
Source

Pobiera lub ustawia nazwę aplikacji lub obiekt, który powoduje błąd.Gets or sets the name of the application or the object that causes the error.

(Odziedziczone po Exception)
StackTrace

Pobiera ciąg reprezentujący bezpośrednie ramki w stosie wywołań.Gets a string representation of the immediate frames on the call stack.

(Odziedziczone po Exception)
TargetSite

Pobiera metodę, która zgłasza bieżący wyjątek.Gets the method that throws the current exception.

(Odziedziczone po Exception)
WrappedException

Pobiera obiekt, który został opakowany przez obiekt RuntimeWrappedException.Gets the object that was wrapped by the RuntimeWrappedException object.

Metody

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetBaseException()

Gdy jest zastępowany w klasie pochodnej, zwraca Exception, który jest główną przyczyną jednego lub kilku kolejnych wyjątków.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Odziedziczone po Exception)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)

Ustawia obiekt SerializationInfo z informacjami o wyjątku.Sets the SerializationInfo object with information about the exception.

GetType()

Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia.Gets the runtime type of the current instance.

(Odziedziczone po Exception)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.Creates and returns a string representation of the current exception.

(Odziedziczone po Exception)

Zdarzenia

SerializeObjectState

Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku, który zawiera serializowane dane dotyczące wyjątku.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Odziedziczone po Exception)

Dotyczy