COMException Construtores

Definição

Inicializa uma nova instância da COMException classe.

Sobrecargas

Name Description
COMException()

Inicializa uma nova instância da COMException classe com valores por defeito.

COMException(String)

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

COMException(SerializationInfo, StreamingContext)
Obsoleto.

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

COMException(String, Exception)

Inicializa uma nova instância da COMException classe 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 COMException classe com uma mensagem e código de erro especificados.

COMException()

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

Inicializa uma nova instância da COMException classe com valores por defeito.

public:
 COMException();
public COMException();
Public Sub New ()

Observações

COMException herda de ExternalException. A tabela seguinte mostra como este construtor define as propriedades do Exception objeto.

Property Value
InnerException null.
Message Uma cadeia de mensagens de erro localizadas.

Aplica-se a

COMException(String)

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

Inicializa uma nova instância da COMException classe 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 a razão da exceção.

Observações

COMException herda de ExternalException. A tabela seguinte mostra como este construtor define as propriedades do Exception objeto.

Property Value
InnerException null
Message message

Aplica-se a

COMException(SerializationInfo, StreamingContext)

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

Atenção

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

Inicializa uma nova instância da COMException classe a partir 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);
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
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 SerializationInfo objeto que contém os dados do objeto serializado.

context
StreamingContext

O StreamingContext objeto que fornece a informação contextual sobre a origem ou destino.

Atributos

Exceções

info é null.

Observações

Este construtor é chamado durante a desserialização para reconstituir o objeto exceção transmitido através de um fluxo. Para mais informações, consulte XML e Serialização SOAP.

COMException herda de ExternalException.

Ver também

Aplica-se a

COMException(String, Exception)

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

Inicializa uma nova instância da COMException classe 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);
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. Se o inner parâmetro não nullfor , a exceção atual é elevada num catch bloco que gere a exceção interna.

Observações

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

A tabela seguinte mostra como este construtor define as propriedades do Exception objeto.

Property Value
InnerException A referência à exceção interna.
Message A cadeia de mensagens de erro.

Ver também

Aplica-se a

COMException(String, Int32)

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

Inicializa uma nova instância da COMException classe com uma mensagem e 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 a razão pela qual a exceção ocorreu.

errorCode
Int32

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

Observações

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

COMException herda de ExternalException. A tabela seguinte mostra como este construtor define as propriedades do Exception objeto.

Property Value
InnerException null
Message message

Aplica-se a