RuntimeWrappedException Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Opakowuje wyjątek, który nie pochodzi z Exception klasy. Klasa ta nie może być dziedziczona.
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
- Dziedziczenie
- Atrybuty
Przykłady
W poniższym przykładzie kodu pokazano, jak zgłosić String obiekt jako wyjątek w języku C++ i przechwycić go przy użyciu RuntimeWrappedException obiektu.
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. Inne języki, takie jak Microsoft C# i Visual Basic, wymagają, aby każdy zgłoszony wyjątek pochodził od Exception klasy. Aby zachować zgodność między językami, środowisko uruchomieniowe języka wspólnego (CLR) opakowuje obiekty, które nie pochodzą z Exception obiektu RuntimeWrappedException .
Można użyć RuntimeCompatibilityAttribute klasy, aby określić, czy wyjątki powinny być opakowane wewnątrz bloków catch i filtrów wyjątków dla zestawu. Wiele kompilatorów języka, w tym microsoft C# i Visual Basic kompilatorów, domyślnie stosuje ten atrybut, aby określić zachowanie opakowujące.
Należy pamiętać, że środowisko uruchomieniowe nadal zawija wyjątki, nawet jeśli używasz RuntimeCompatibilityAttribute klasy do określenia, że nie chcesz ich opakować. W takim przypadku wyjątki są niezapisane tylko wewnątrz bloków przechwytywania lub filtrów wyjątków.
Konstruktory
RuntimeWrappedException(Object) |
Inicjuje nowe wystąpienie obiektu zawierającego wewnętrzny obiekt wyjątku RuntimeWrappedException . |
Właściwości
Data |
Pobiera kolekcję par klucz/wartość, które zapewniają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku. (Odziedziczone po Exception) |
HelpLink |
Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem. (Odziedziczone po Exception) |
HResult |
Pobiera lub ustawia HRESULT, zakodowaną wartość liczbową przypisaną do określonego wyjątku. (Odziedziczone po Exception) |
InnerException |
Exception Pobiera wystąpienie, które spowodowało bieżący wyjątek. (Odziedziczone po Exception) |
Message |
Pobiera komunikat opisujący bieżący wyjątek. (Odziedziczone po Exception) |
Source |
Pobiera lub ustawia nazwę aplikacji lub obiektu, który powoduje błąd. (Odziedziczone po Exception) |
StackTrace |
Pobiera reprezentację ciągu natychmiastowych ramek w stosie wywołań. (Odziedziczone po Exception) |
TargetSite |
Pobiera metodę, która zgłasza bieżący wyjątek. (Odziedziczone po Exception) |
WrappedException |
Pobiera obiekt, który został opakowany przez RuntimeWrappedException obiekt. |
Metody
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetBaseException() |
Po przesłonięciu w klasie pochodnej funkcja zwraca Exception główną przyczynę co najmniej jednego kolejnego wyjątku. (Odziedziczone po Exception) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetObjectData(SerializationInfo, StreamingContext) |
SerializationInfo Ustawia obiekt z informacjami o wyjątku. |
GetType() |
Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia. (Odziedziczone po Exception) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
ToString() |
Tworzy i zwraca reprezentację ciągu bieżącego wyjątku. (Odziedziczone po Exception) |
Zdarzenia
SerializeObjectState |
Nieaktualne.
Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku zawierającego serializowane dane o wyjątku. (Odziedziczone po Exception) |