COMException Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- 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 objeto Exception.
| 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.COMExceptionPublic 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 |
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 de 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.COMExceptionProtected 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
Exceções
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
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 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.COMExceptionPublic 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
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.COMExceptionPublic 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 |
