COMException Constructors

Definition

Inicializa uma nova instância da classe COMException.Initializes a new instance of the COMException class.

Overloads

COMException()

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

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(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, 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)

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.

COMException()

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

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

Remarks

COMException herda de ExternalException.COMException inherits from ExternalException. A tabela a seguir mostra como esse construtor define as propriedades do objeto Exception.The following table shows how this constructor sets the properties of the Exception object.

PropriedadeProperty {1>Valor<1}Value
InnerException nullnull.
Message Uma cadeia de caracteres de mensagem de erro localizada.A localized error message 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.

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)

Parameters

message
String

A mensagem que indica o motivo da exceção.The message that indicates the reason for the exception.

Remarks

COMException herda de ExternalException.COMException inherits from ExternalException. A tabela a seguir mostra como esse construtor define as propriedades do objeto Exception.The following table shows how this constructor sets the properties of the Exception object.

PropriedadeProperty {1>Valor<1}Value
InnerException null
Message message

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.

protected:
 COMException(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);
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
Protected Sub New (info As SerializationInfo, context As StreamingContext)

Parameters

info
SerializationInfo

O objeto SerializationInfo que mantém os dados de objeto serializados.The SerializationInfo object that holds the serialized object data.

context
StreamingContext

O objeto StreamingContext que fornece as informações contextuais sobre a origem ou o destino.The StreamingContext object that supplies the contextual information about the source or destination.

Exceptions

info é null.info is null.

Remarks

O construtor é chamado durante a desserialização para reconstituir o objeto de exceção transmitido em um fluxo.This constructor is called during deserialization to reconstitute the exception object transmitted over a stream. Para obter mais informações, consulte serialização XML e SOAP.For more information, see XML and SOAP Serialization.

COMException herda de ExternalException.COMException inherits from ExternalException.

See also

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.

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)

Parameters

message
String

A mensagem de erro que explica a razão da exceção.The error message that explains the reason for the exception.

inner
Exception

A exceção que é a causa da exceção atual.The exception that is the cause of the current exception. Caso o parâmetro inner não seja null, a exceção atual é acionada em um bloco catch que identifica a exceção interna.If the inner parameter is not null, the current exception is raised in a catch block that handles the inner exception.

Remarks

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.An exception that is thrown as a direct result of a previous exception should include a reference to the previous exception in the InnerException property. A propriedade InnerException retorna o mesmo valor que é passado para o construtor, ou null caso a propriedade InnerException não forneça o valor de exceção interno para o construtor.The InnerException property returns the same value that is passed into the constructor, or null if the InnerException property does not supply the inner exception value to the constructor.

A tabela a seguir mostra como esse construtor define as propriedades do objeto Exception.The following table shows how this constructor sets the properties of the Exception object.

PropriedadeProperty {1>Valor<1}Value
InnerException A referência de exceção interna.The inner exception reference.
Message A cadeia de caracteres da mensagem de erro.The error message string.

See also

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.

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)

Parameters

message
String

A mensagem que indica o motivo pelo qual a exceção ocorreu.The message that indicates the reason the exception occurred.

errorCode
Int32

O valor do código do erro (HRESULT) associado a esta exceção.The error code (HRESULT) value associated with this exception.

Remarks

Esse construtor de COMException define a mensagem base com o código de erro.This COMException constructor sets the base message with the error code.

COMException herda de ExternalException.COMException inherits from ExternalException. A tabela a seguir mostra como esse construtor define as propriedades do objeto Exception.The following table shows how this constructor sets the properties of the Exception object.

PropriedadeProperty {1>Valor<1}Value
InnerException null
Message message

Applies to