COMException COMException COMException COMException Class

Definição

A exceção é lançada quando um HRESULT não reconhecido retorna de uma chamada de método COM.The exception that is thrown when an unrecognized HRESULT is returned from a COM method call.

public ref class COMException : System::Runtime::InteropServices::ExternalException
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class COMException : System.Runtime.InteropServices.ExternalException
type COMException = class
    inherit ExternalException
Public Class COMException
Inherits ExternalException
Herança
Derivado
Atributos

Comentários

O common language runtime transforma HRESULTs conhecido em exceções do .NET Framework, permitindo que objetos COM retornar informações de erro significativas para os clientes gerenciados.The common language runtime transforms well-known HRESULTs to .NET Framework exceptions, enabling COM objects to return meaningful error information to managed clients. O HRESULT para mapeamento de exceção também funciona na outra direção, retornando HRESULTs específicos para clientes não gerenciados.The HRESULT to exception mapping also works in the other direction by returning specific HRESULTs to unmanaged clients. Para obter detalhes de mapeamento, consulte como: Mapear HRESULTs e exceções.For mapping details, see How to: Map HRESULTs and Exceptions.

Quando o tempo de execução encontra um HRESULT incomum (um HRESULT que não tem uma exceção específica, correspondente), ele gera uma instância da COMException classe.When the runtime encounters an unfamiliar HRESULT (an HRESULT that lacks a specific, corresponding exception), it throws an instance of the COMException class. Essa exceção de todas as finalidades e expõe os mesmos membros que qualquer exceção e herda um público ErrorCode propriedade que contém o HRESULT retornado pelo receptor.This all-purpose exception exposes the same members as any exception, and inherits a public ErrorCode property that contains the HRESULT returned by the callee. Se uma mensagem de erro está disponível para o tempo de execução (obtido o IErrorInfo interface ou o Err objeto no Visual Basic ou em alguns casos do sistema operacional), a mensagem é retornada ao chamador.If an error message is available to the runtime (obtained from the IErrorInfo interface or the Err object in Visual Basic, or in some cases from the operating system), the message is returned to the caller. No entanto, se o desenvolvedor do componente COM não incluir uma mensagem de erro, o tempo de execução retornará o HRESULT de oito dígitos no lugar de uma cadeia de caracteres de mensagem.However, if the COM component developer fails to include an error message, the runtime returns the eight-digit HRESULT in place of a message string. Ter um HRESULT permite que o chamador determinar a causa da exceção genérica.Having an HRESULT allows the caller to determine the cause of the generic exception.

Tratando uma exceção de COMExceptionHandling a COMException exception

A seguir estão algumas considerações para a solução de problemas de um COMException exceção.The following are some considerations for troubleshooting a COMException exception.

Verifique o ErrorCode propriedadeCheck the ErrorCode property
Quando o tempo de execução encontra um HRESULT incomum e lança um COMException exceção, o ErrorCode propriedade inclui a mensagem de erro ou, se uma mensagem de erro não estiver disponível, o valor HRESULT de oito dígitos.When the runtime encounters an unfamiliar HRESULT and throws a COMException exception, the ErrorCode property includes either the error message or, if an error message is unavailable, the eight-digit HRESULT value. A mensagem de erro ou o valor HRESULT pode ajudá-lo a determinar a causa da exceção.The error message or the HRESULT value can help you determine the cause of the exception.

Para obter uma lista de valores HRESULT, consulte valores HRESULT comuns.For a list of HRESULT values, see Common HRESULT Values.

Argumentos de associação tardia e objetos do Microsoft OfficeLate-bound arguments and Microsoft Office objects
Ao passar argumentos de associação tardia para métodos de objetos do Microsoft Office, um COMException exceção poderá ser gerada quando os objetos são objetos COM.When passing late-bound arguments to methods of Microsoft Office objects, a COMException exception may be thrown when the objects are COM objects. A associação tardia presume que essas chamadas de método envolvem um parâmetro ByRef e que a propriedade passada por você tem um acessador set.The late binder assumes that such method calls involve a ByRef parameter and that the property you pass has a set accessor. Se a propriedade não existir, o .NET Framework gera uma MissingMethodException exceção (com um CORE_E_MISSINGMETHOD HRESULT).If the property does not, the .NET Framework generates a MissingMethodException exception (with a CORE_E_MISSINGMETHOD HRESULT ). Para contornar esse comportamento, use objetos de associação antecipada ou passe uma variável em vez de uma propriedade do objeto.To work around this behavior, use early-bound objects or pass a variable instead of a property of the object.

Visual Studio e o processo de hospedagemVisual Studio and the hosting process
COM é usado para comunicação entre o Visual Studio e o processo de hospedagem.COM is used to communicate between Visual Studio and the hosting process. Porque ela é usada antes de executar o código, uma chamada para CoInitializeSecurity faz com que essa exceção seja lançada.Because it is used before code runs, a call to CoInitializeSecurity causes this exception to be thrown.

Em alguns casos, executando o Visual Studio como administrador pode resolver o problema.In some cases, running Visual Studio as Administrator may resolve the issue. Você também pode desabilitar o processo de hospedagem.You can also disable the hosting process.

Lançar uma exceção de COMExceptionThrowing a COMException exception

Embora você possa usar o COMException classe retornar HRESULTs específicos para clientes não gerenciados, lançando uma exceção específica do .NET Framework é melhor do que usar uma exceção genérica.Although you can use the COMException class to return specific HRESULTs to unmanaged clients, throwing a specific .NET Framework exception is better than using a generic exception. Considere que os clientes gerenciados, bem como os clientes não gerenciados podem usar o objeto do .NET Framework e lançar um HRESULT para um chamador gerenciado é menos abrangente que gerar uma exceção.Consider that managed clients as well as unmanaged clients can use your .NET Framework object, and throwing an HRESULT to a managed caller is less comprehensible than throwing an exception.

Construtores

COMException() COMException() COMException() COMException()

Inicializa uma nova instância da classe COMException com valores padrão.Initializes a new instance of the COMException class with default values.

COMException(SerializationInfo, StreamingContext) COMException(SerializationInfo, StreamingContext) COMException(SerializationInfo, StreamingContext) COMException(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe COMException dos dados de serialização.Initializes a new instance of the COMException class from serialization data.

COMException(String) COMException(String) COMException(String) COMException(String)

Inicializa uma nova instância da classe COMException com uma mensagem especificada.Initializes a new instance of the COMException class with a specified message.

COMException(String, Exception) COMException(String, Exception) COMException(String, Exception) COMException(String, Exception)

Inicializa uma nova instância da classe COMException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.Initializes a new instance of the COMException class with a specified error message and a reference to the inner exception that is the cause of this exception.

COMException(String, Int32) COMException(String, Int32) COMException(String, Int32) COMException(String, Int32)

Inicializa uma nova instância da classe COMException com uma mensagem e um código de erro especificados.Initializes a new instance of the COMException class with a specified message and error code.

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBaseException() GetBaseException() GetBaseException() GetBaseException()

Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Inherited from Exception)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Quando substituído em uma classe derivada, define o SerializationInfo com informações sobre a exceção.When overridden in a derived class, sets the SerializationInfo with information about the exception.

(Inherited from Exception)
GetType() GetType() GetType() GetType()

Obtém o tipo de tempo de execução da instância atual.Gets the runtime type of the current instance.

(Inherited from Exception)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Converte o conteúdo da exceção em uma cadeia de caracteres.Converts the contents of the exception to a string.

Propriedades

Data Data Data Data

Obtém uma coleção de pares de chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Inherited from Exception)
ErrorCode ErrorCode ErrorCode ErrorCode

Obtém o HRESULT do erro.Gets the HRESULT of the error.

(Inherited from ExternalException)
HelpLink HelpLink HelpLink HelpLink

Obtém ou define um link para o arquivo de ajuda associado a essa exceção.Gets or sets a link to the help file associated with this exception.

(Inherited from Exception)
HResult HResult HResult HResult

Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Inherited from Exception)
InnerException InnerException InnerException InnerException

Obtém a instância Exception que causou a exceção atual.Gets the Exception instance that caused the current exception.

(Inherited from Exception)
Message Message Message Message

Obtém uma mensagem que descreve a exceção atual.Gets a message that describes the current exception.

(Inherited from Exception)
Source Source Source Source

Obtém ou define o nome do aplicativo ou objeto que causa o erro.Gets or sets the name of the application or the object that causes the error.

(Inherited from Exception)
StackTrace StackTrace StackTrace StackTrace

Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas.Gets a string representation of the immediate frames on the call stack.

(Inherited from Exception)
TargetSite TargetSite TargetSite TargetSite

Obtém o método que gerou a exceção atual.Gets the method that throws the current exception.

(Inherited from Exception)

Eventos

SerializeObjectState SerializeObjectState SerializeObjectState SerializeObjectState

Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Inherited from Exception)

Aplica-se a

Veja também