SEHException Class

Definition

Stellt SEH-Fehler (Structured Exception Handler, strukturierter Ausnahmehandler) dar.Represents structured exception handling (SEH) errors.

public ref class SEHException : Exception
public ref class SEHException : System::Runtime::InteropServices::ExternalException
public class SEHException : Exception
public class SEHException : System.Runtime.InteropServices.ExternalException
[System.Serializable]
public class SEHException : System.Runtime.InteropServices.ExternalException
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class SEHException : System.Runtime.InteropServices.ExternalException
type SEHException = class
    inherit Exception
type SEHException = class
    inherit ExternalException
Public Class SEHException
Inherits Exception
Public Class SEHException
Inherits ExternalException
Inheritance
SEHException
Inheritance
Attributes

Remarks

Die SEHException-Klasse behandelt SEH-Fehler, die von nicht verwaltetem Code ausgelöst werden, jedoch keiner anderen .NET Framework Ausnahme zugeordnet wurden.The SEHException class handles SEH errors that are thrown from unmanaged code, but that have not been mapped to another .NET Framework exception. Die SEHException-Klasse entspricht auch der HRESULT E_FAIL (0x80004005).The SEHException class also corresponds to the HRESULT E_FAIL (0x80004005).

Der .NET Framework stößt häufig auf nicht verwaltete SEH-Ausnahmen, die automatisch verwalteten Entsprechungen zugeordnet werden.The .NET Framework often encounters unmanaged SEH exceptions that are automatically mapped to managed equivalents. Es gibt zwei häufige nicht verwaltete SEH-Ausnahmen:There are two common unmanaged SEH exceptions:

  • STATUS_NO_MEMORY Ausnahmen werden automatisch der OutOfMemoryException-Klasse zugeordnet.STATUS_NO_MEMORY exceptions are automatically mapped to the OutOfMemoryException class.

  • STATUS_ACCESS_VIOLATION Ausnahmen werden automatisch wie folgt zugeordnet:STATUS_ACCESS_VIOLATION exceptions are automatically mapped as follows:

    • Wenn legacyNullReferencePolicy angewendet wird, werden alle Zugriffs Verstöße der NullReferenceException-Klasse zugeordnet.If legacyNullReferencePolicy is applied, all access violations are mapped to the NullReferenceException class.

    • Wenn die Adresse, an der der Lese-/Schreibversuch ausgeführt wurde, nicht in JIT-kompiliertem Code erfolgt, wird die Ausnahme der AccessViolationException-Klasse zugeordnet.If the address at which the read/write was attempted is not in JIT-compiled code, the exception is mapped to the AccessViolationException class.

    • Wenn die Adresse, an der der Lese-/Schreibvorgang durchgeführt wurde, in JIT-kompiliertem Code erfolgt, sich aber nicht im Bereich Betriebssystem-NULL-Partition befindet, wird die Ausnahme der AccessViolationException-Klasse zugeordnet.If the address at which the read/write was attempted is in JIT-compiled code, but it is not in the OS Null partition area, the exception is mapped to the AccessViolationException class.

    • Wenn keine legacyNullReferencePolicyvorhanden sind und die Adresse, an der der Lese-/Schreibvorgang versucht wurde, in JIT-kompiliertem Code und im Bereich Betriebssystem-NULL-Partition vorhanden ist, wird die Ausnahme der Klasse NullReferenceException zugeordnet.If there is no legacyNullReferencePolicy, and the address at which the read/write was attempted is in JIT-compiled code and in the OS Null partition area, the exception is mapped to the NullReferenceException class.

Alle SEH-Ausnahmen, die nicht automatisch einer bestimmten Ausnahme zugeordnet werden, werden standardmäßig der SEHException-Klasse zugeordnet.Any SEH exception that is not automatically mapped to a specific exception is mapped to the SEHException class by default.

Beachten Sie, dass die SEHException-Klasse nicht bewirkt C++ , dass nicht verwaltete ausnahmedekonstruktoren aufgerufen werden.Note that the SEHException class does not cause unmanaged C++ exception destructors to be called. Um sicherzustellen, dass C++ Destruktoren der nicht verwalteten Ausnahmen aufgerufen werden, verwenden Sie die folgende Syntax im catch-Block.To ensure that unmanaged C++ exception destructors are called, use the following syntax in the catch block.

Catch   
     ' Handle catch here.  
End Try  
catch  
{  
     // Handle catch here.  
}  
catch(…)  
{  
     // Handle catch here.  
}   

Constructors

SEHException()

Initialisiert eine neue Instanz der Klasse SEHException.Initializes a new instance of the SEHException class.

SEHException(SerializationInfo, StreamingContext)

Initialisiert eine neue Instanz der SEHException-Klasse aus Serialisierungsdaten.Initializes a new instance of the SEHException class from serialization data.

SEHException(String)

Initialisiert eine neue Instanz der SEHException-Klasse mit einer angegebenen Meldung.Initializes a new instance of the SEHException class with a specified message.

SEHException(String, Exception)

Initialisiert eine neue Instanz der SEHException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme, die die Ursache für diese Ausnahme bildet.Initializes a new instance of the SEHException class with a specified error message and a reference to the inner exception that is the cause of this exception.

Properties

Data

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
ErrorCode

Ruft das HRESULT des Fehlers ab.Gets the HRESULT of the error.

(Inherited from ExternalException)
HelpLink

Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult

Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException

Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message

Ruft eine Meldung ab, mit der die aktuelle Ausnahme beschrieben wird.Gets a message that describes the current exception.

(Inherited from Exception)
Source

Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace

Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite

Ruft die Methode ab, die die aktuelle Ausnahme auslöst.Gets the method that throws the current exception.

(Inherited from Exception)

Methods

CanResume()

Gibt an, ob der Zustand vor der Ausnahme wiederhergestellt werden kann und ob der Code ab der Stelle, an der die Ausnahme ausgelöst wurde, weiter ausgeführt werden kann.Indicates whether the exception can be recovered from, and whether the code can continue from the point at which the exception was thrown.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException()

Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die Grundursache für eine oder mehrere nachfolgende Ausnahmen ist.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext)

Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Inherited from Exception)
GetType()

Ruft den Laufzeittyp der aktuellen Instanz ab.Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück.Creates and returns a string representation of the current exception.

(Inherited from Exception)
ToString()

Gibt eine Zeichenfolge zurück, die das HRESULT des Fehlers enthält.Returns a string that contains the HRESULT of the error.

(Inherited from ExternalException)

Events

SerializeObjectState

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Applies to

See also