Freigeben über


ExternalException-Klasse

 

Veröffentlicht: Oktober 2016

Der Basisausnahmetyp für alle COM-Interop- und SEH-Ausnahmen (Structured Exception Handling, Strukturierte Ausnahmebehandlung).

Namespace:   System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)

Vererbungshierarchie

System.Object
  System.Exception
    System.SystemException
      System.Runtime.InteropServices.ExternalException
        Microsoft.JScript.Vsa.JSVsaException
        System.ComponentModel.Design.CheckoutException
        System.ComponentModel.Win32Exception
        System.Data.Common.DbException
        System.Messaging.MessageQueueException
        System.Runtime.InteropServices.COMException
        System.Runtime.InteropServices.SEHException
        System.ServiceModel.MsmqException
        System.Web.HttpException

Syntax

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ExternalException : SystemException
[SerializableAttribute]
[ComVisibleAttribute(true)]
public ref class ExternalException : SystemException
[<SerializableAttribute>]
[<ComVisibleAttribute(true)>]
type ExternalException = 
    class
        inherit SystemException
    end
<SerializableAttribute>
<ComVisibleAttribute(True)>
Public Class ExternalException
    Inherits SystemException

Konstruktoren

Name Beschreibung
System_CAPS_pubmethod ExternalException()

Initialisiert eine neue Instanz der ExternalException-Klasse mit Standardeigenschaften.

System_CAPS_protmethod ExternalException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der ExternalException -Klasse aus Serialisierungsdaten.

System_CAPS_pubmethod ExternalException(String)

Initialisiert eine neue Instanz der ExternalException-Klasse mit einer angegebenen Fehlermeldung.

System_CAPS_pubmethod ExternalException(String, Exception)

Initialisiert eine neue Instanz der ExternalException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die diese Ausnahme ausgelöst hat.

System_CAPS_pubmethod ExternalException(String, Int32)

Initialisiert eine neue Instanz der ExternalException -Klasse mit einer angegebenen Fehlermeldung und dem HRESULT des Fehlers.

Eigenschaften

Name Beschreibung
System_CAPS_pubproperty Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen über die Ausnahme bereitstellen.(Geerbt von „Exception“.)

System_CAPS_pubproperty ErrorCode

Ruft das HRESULT des Fehlers ab.

System_CAPS_pubproperty HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.(Geerbt von „Exception“.)

System_CAPS_pubproperty HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.(Geerbt von „Exception“.)

System_CAPS_pubproperty InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.(Geerbt von „Exception“.)

System_CAPS_pubproperty Message

Ruft eine Meldung ab, die die aktuelle Ausnahme beschreibt.(Geerbt von „Exception“.)

System_CAPS_pubproperty Source

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.(Geerbt von „Exception“.)

System_CAPS_pubproperty StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.(Geerbt von „Exception“.)

System_CAPS_pubproperty TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.(Geerbt von „Exception“.)

Methoden

Name Beschreibung
System_CAPS_pubmethod Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethod Finalize()

Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.(Geerbt von „Object“.)

System_CAPS_pubmethod GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist.(Geerbt von „Exception“.)

System_CAPS_pubmethod GetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethod GetObjectData(SerializationInfo, StreamingContext)

Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest.(Geerbt von „Exception“.)

System_CAPS_pubmethod GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.(Geerbt von „Exception“.)

System_CAPS_protmethod MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_pubmethod ToString()

Gibt eine Zeichenfolge, die das HRESULT des Fehlers enthält.(Überschreibt Exception.ToString().)

Ereignisse

Name Beschreibung
System_CAPS_protevent SerializeObjectState

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt zu erstellen, das serialisierte Daten für die Ausnahme enthält.(Geerbt von „Exception“.)

Hinweise

To enhance interoperability between legacy systems and the common language runtime, the P:System.Runtime.InteropServices.ExternalException.ErrorCode property stores an integer value (HRESULT) that identifies the error. User defined exceptions should never derive from ExternalException, and an ExternalException should never be thrown by user code. Use the specific exceptions that derive from ExternalException instead.

ExternalException uses the HRESULT E_FAIL which has the value 0x80004005.

ExternalException uses the default Equals implementation, which supports reference equality.

For a list of initial values for an instance of ExternalException, see the ExternalException constructors.

Versionsinformationen

.NET Framework
Verfügbar seit 1.1
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0

Threadsicherheit

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Siehe auch

Exception
System.Runtime.InteropServices-Namespace
Behandeln und Auslösen von Ausnahmen

Zurück zum Anfang