COMException-Klasse
Die Ausnahme, die ausgelöst wird, wenn ein COM-Methodenaufruf ein nicht erkanntes HRESULT zurückgibt.
Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class COMException
Inherits ExternalException
'Usage
Dim instance As COMException
[SerializableAttribute]
[ComVisibleAttribute(true)]
public class COMException : ExternalException
[SerializableAttribute]
[ComVisibleAttribute(true)]
public ref class COMException : public ExternalException
/** @attribute SerializableAttribute() */
/** @attribute ComVisibleAttribute(true) */
public class COMException extends ExternalException
SerializableAttribute
ComVisibleAttribute(true)
public class COMException extends ExternalException
Hinweise
Die Common Language Runtime wandelt bekannte HRESULTs in .NET-Ausnahmen um, wodurch COM-Objekte an verwaltete Clients sinnvolle Fehlerinformationen zurückgeben können. Die Zuordnung von HRESULTs zu Ausnahmen funktioniert auch umgekehrt, da bestimmte HRESULTs an nicht verwaltete Clients zurückgegeben werden können. Ausführliche Informationen über das Zuordnen finden Sie unter Gewusst wie: Zuordnen von HRESULTs und Ausnahmen.
Wenn die Laufzeit ein unbekanntes HRESULT findet (ein HRESULT, für das keine entsprechende spezifische Ausnahme vorhanden ist), wird eine Instanz der COMException-Klasse ausgelöst. Diese allgemeine Ausnahme legt dieselben Member wie alle anderen Ausnahmen offen, und sie enthält eine öffentliche ErrorCode-Eigenschaft, die das vom Aufgerufenen zurückgegebene HRESULT enthält. Wenn für die Laufzeit eine Fehlermeldung verfügbar ist (abgerufen von der IErrorInfo-Schnittstelle bzw. dem Err-Objekt in Visual Basic oder in einigen Fällen vom Betriebssystem), wird die Meldung an den Aufrufer zurückgegeben. Wenn der Entwickler der COM-Komponente jedoch keine Fehlermeldung einbindet, gibt die Laufzeit das achtstellige HRESULT anstelle einer Meldungszeichenfolge zurück. Das Vorhandensein eines HRESULT ermöglicht es dem Aufrufer, die Ursache der allgemeinen Ausnahme zu bestimmen.
Obwohl Sie mit der COMException-Klasse bestimmte HRESULTs an nicht verwaltete Clients zurückgeben können, empfiehlt sich das Auslösen einer bestimmten .NET-Ausnahme anstelle einer allgemeinen Ausnahme. Beachten Sie, dass verwaltete Clients ebenso wie nicht verwaltete Clients das .NET-Objekt verwenden können und dass das Auslösen eines HRESULT für einen verwalteten Aufrufer weniger verständlich ist als das einer Ausnahme.
Vererbungshierarchie
System.Object
System.Exception
System.SystemException
System.Runtime.InteropServices.ExternalException
System.Runtime.InteropServices.COMException
System.DirectoryServices.DirectoryServicesCOMException
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0
Siehe auch
Referenz
COMException-Member
System.Runtime.InteropServices-Namespace
Exception