COMException Construtores

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Inicializa uma nova instância da classe COMException.

Sobrecargas

COMException()	Inicializa uma nova instância da classe COMException com valores padrão.
COMException(String)	Inicializa uma nova instância da classe COMException com uma mensagem especificada.
COMException(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe COMException de dados de serialização.
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 dessa exceção.
COMException(String, Int32)	Inicializa uma nova instância da classe COMException com uma mensagem e um código de erro especificados.

COMException()

Origem:

COMException.cs

Inicializa uma nova instância da classe COMException com valores padrão.

public:
 COMException();

public COMException ();

Public Sub New ()

Comentários

COMException herda de ExternalException. A tabela a seguir mostra como esse construtor define as propriedades do objeto Exception.

Propriedade	Valor
InnerException	null.
Message	Uma cadeia de caracteres de mensagem de erro localizada.

COMException(String)

Origem:

COMException.cs

Inicializa uma nova instância da classe COMException com uma mensagem especificada.

public:
 COMException(System::String ^ message);

public COMException (string? message);

new System.Runtime.InteropServices.COMException : string -> System.Runtime.InteropServices.COMException

Public Sub New (message As String)

Parâmetros

message

String

A mensagem que indica o motivo da exceção.

Comentários

COMException herda de ExternalException. A tabela a seguir mostra como esse construtor define as propriedades do objeto Exception.

Propriedade	Valor
InnerException	null
Message	message

COMException(SerializationInfo, StreamingContext)

Origem:

COMException.cs

Cuidado

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa uma nova instância da classe COMException de dados de serialização.

protected:
 COMException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected COMException (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Runtime.InteropServices.COMException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Runtime.InteropServices.COMException

Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parâmetros

info

SerializationInfo

O objeto SerializationInfo que contém os dados do objeto serializado.

context

StreamingContext

O objeto StreamingContext que fornece as informações contextuais sobre a origem ou o destino.

Atributos

ObsoleteAttribute

Exceções

ArgumentNullException

info é null.

Comentários

Esse construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido por um fluxo. Para obter mais informações, consulte de serialização XML e SOAP.

COMException herda de ExternalException.

Confira também

• ExternalException

COMException(String, Exception)

Origem:

COMException.cs

Inicializa uma nova instância da classe COMException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa dessa exceção.

public:
 COMException(System::String ^ message, Exception ^ inner);

public COMException (string? message, Exception? inner);

new System.Runtime.InteropServices.COMException : string * Exception -> System.Runtime.InteropServices.COMException

Public Sub New (message As String, inner As Exception)

Parâmetros

message

String

A mensagem de erro que explica o motivo da exceção.

inner

Exception

A exceção que é a causa da exceção atual. Se o parâmetro inner não for null, a exceção atual será gerada em um bloco de catch que manipula a exceção interna.

Comentários

Uma exceção gerada como resultado direto de uma exceção anterior deve incluir uma referência à exceção anterior na propriedade InnerException. A propriedade InnerException retorna o mesmo valor que é passado para o construtor ou null se a propriedade InnerException não fornecer o valor de exceção interna ao construtor.

A tabela a seguir mostra como esse construtor define as propriedades do objeto Exception.

Propriedade	Valor
InnerException	A referência de exceção interna.
Message	A cadeia de caracteres de mensagem de erro.

Confira também

• Exception
• Manipulação e geração de exceções no .NET

COMException(String, Int32)

Origem:

COMException.cs

Inicializa uma nova instância da classe COMException com uma mensagem e um código de erro especificados.

public:
 COMException(System::String ^ message, int errorCode);

public COMException (string? message, int errorCode);

new System.Runtime.InteropServices.COMException : string * int -> System.Runtime.InteropServices.COMException

Public Sub New (message As String, errorCode As Integer)

Parâmetros

message

String

A mensagem que indica o motivo da exceção ter ocorrido.

errorCode

Int32

O valor hresult (código de erro) associado a essa exceção.

Comentários

Esse construtor COMException define a mensagem base com o código de erro.

COMException herda de ExternalException. A tabela a seguir mostra como esse construtor define as propriedades do objeto Exception.

Propriedade	Valor
InnerException	null
Message	message