COMException Classe

Définition

public ref class COMException : Exception

public ref class COMException : System::Runtime::InteropServices::ExternalException

public class COMException : Exception

public class COMException : System.Runtime.InteropServices.ExternalException

[System.Serializable]
public class COMException : System.Runtime.InteropServices.ExternalException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class COMException : System.Runtime.InteropServices.ExternalException

type COMException = class
    inherit Exception

type COMException = class
    inherit ExternalException

[<System.Serializable>]
type COMException = class
    inherit ExternalException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type COMException = class
    inherit ExternalException

Public Class COMException
Inherits Exception

Public Class COMException
Inherits ExternalException

Héritage

Object

Exception

COMException

Héritage

Object

Exception

SystemException

ExternalException

COMException

Dérivé

System.DirectoryServices.DirectoryServicesCOMException

Attributs

SerializableAttribute ComVisibleAttribute

Remarques

La classe COMException est l'exception levée quand un HRESULT non reconnu est retourné d'appel de méthode COM.

Le Common Language Runtime transforme les HRESULT connus en exceptions .NET, ce qui permet aux objets COM de retourner des informations d’erreur significatives aux clients gérés. Le mappage d'un HRESULT à une exception fonctionne également dans l'autre direction, en retournant des HRESULT spécifiques aux clients non managés. Pour plus d’informations sur le mappage, consultez Comment mapper les HRESULT et les exceptions.

Lorsque le runtime rencontre un HRESULT inconnu (HRESULT qui n’a pas d’exception spécifique, correspondante), il lève une instance de la COMException classe. Cette exception à usage général expose les mêmes membres que n’importe quelle exception et hérite d’une propriété publique ErrorCode qui contient le HRESULT retourné par l’appelé. Si un message d’erreur est disponible pour le runtime (obtenu à partir de l’interface IErrorInfo ou de l’objet Err en Visual Basic, ou dans certains cas du système d’exploitation), le message est retourné à l’appelant. Toutefois, si le développeur du composant COM ne parvient pas à inclure un message d’erreur, le runtime retourne le HRESULT à huit chiffres à la place d’une chaîne de message. L’utilisation d’un HRESULT permet à l’appelant de déterminer la cause de l’exception générique.

Gérer une exception COMException

Voici quelques considérations relatives à la résolution des problèmes d’une COMException exception.

Vérifiez la ErrorCode propriété Lorsque le runtime rencontre un HRESULT inconnu et lève une COMException exception, la ErrorCode propriété inclut le message d’erreur ou, si un message d’erreur n’est pas disponible, la valeur HRESULT à huit chiffres. Le message d’erreur ou la valeur HRESULT peuvent vous aider à déterminer la cause de l’exception.

Pour obtenir la liste des valeurs HRESULT, consultez Valeurs HRESULT communes.

Lors de la transmission d’arguments à liaison tardive à des méthodes d’objets Microsoft Office, une exception COMException peut être levée lorsque les objets sont des objets COM. Le classeur tardif suppose que ces appels de méthode impliquent un paramètre ByRef et que la propriété que vous passez a un accesseur set . Si la propriété ne le fait pas, .NET génère une MissingMethodException exception (avec un CORE_E_MISSINGMETHOD HRESULT). Pour contourner ce comportement, utilisez des objets à liaison anticipée ou transmettez une variable au lieu d’une propriété de l’objet.

COM est utilisé pour communiquer entre Visual Studio et le processus d’hébergement. Étant donné qu’elle est utilisée avant l’exécution du code, un appel à CoInitializeSecurity entraîne la levée de cette exception. Dans certains cas, l’exécution de Visual Studio en tant qu’administrateur peut résoudre le problème. Vous pouvez également désactiver le processus d’hébergement.

Lever une exception COMException

Bien que vous puissiez utiliser la COMException classe pour retourner des HRESULT spécifiques aux clients non gérés, la levée d’une exception .NET spécifique est préférable à l’utilisation d’une exception générique. Considérez que les clients gérés et les clients non gérés peuvent utiliser votre objet .NET et lever un HRESULT sur un appelant managé est moins compréhensible que de lever une exception.

Voir aussi

• Exception
• Gestion et levée d’exceptions