Partilhar via


COMException Construtores

Definição

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 dos 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 da 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
Origem:
COMException.cs
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 Exception objeto .

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

Aplica-se a

COMException(String)

Origem:
COMException.cs
Origem:
COMException.cs
Origem:
COMException.cs

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

public:
 COMException(System::String ^ message);
public COMException (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 Exception objeto .

Propriedade Valor
InnerException null
Message message

Aplica-se a

COMException(SerializationInfo, StreamingContext)

Origem:
COMException.cs
Origem:
COMException.cs
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 dos dados de serialização.

protected:
 COMException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
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);
new System.Runtime.InteropServices.COMException : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Runtime.InteropServices.COMException
[<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 mantém os dados de objeto serializados.

context
StreamingContext

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

Atributos

Exceções

info é null.

Comentários

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

COMException herda de ExternalException.

Confira também

Aplica-se a

COMException(String, Exception)

Origem:
COMException.cs
Origem:
COMException.cs
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 da exceção.

public:
 COMException(System::String ^ message, Exception ^ inner);
public COMException (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 a razão da exceção.

inner
Exception

A exceção que é a causa da exceção atual. Caso o parâmetro inner não seja null, a exceção atual é acionada em um bloco catch que identifica a exceção interna.

Comentários

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

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

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

Confira também

Aplica-se a

COMException(String, Int32)

Origem:
COMException.cs
Origem:
COMException.cs
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);
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 pelo qual a exceção ocorreu.

errorCode
Int32

O valor do código do erro (HRESULT) associado a esta exceção.

Comentários

Esse COMException construtor 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 Exception objeto .

Propriedade Valor
InnerException null
Message message

Aplica-se a