ExternalException Classe

Definição

O tipo base de exceção para todas as exceções de interoperabilidade COM e exceções de gestão estruturada de exceções (SEH).

public ref class ExternalException : SystemException
[System.Serializable]
public class ExternalException : SystemException
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class ExternalException : SystemException
public class ExternalException : SystemException
[<System.Serializable>]
type ExternalException = class
    inherit SystemException
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ExternalException = class
    inherit SystemException
type ExternalException = class
    inherit SystemException
Public Class ExternalException
Inherits SystemException
Herança
ExternalException
Derivado
Atributos

Observações

Para melhorar a interoperabilidade entre sistemas legados e o runtime da linguagem comum, a ErrorCode propriedade armazena um valor inteiro (HRESULT) que identifica o erro. Exceções definidas pelo utilizador nunca devem derivar de ExternalException, e nunca devem ExternalException ser lançadas pelo código do utilizador. Use as exceções específicas que derivam de em vez disso ExternalException .

ExternalException usa o E_FAIL HRESULT, que tem o valor 0x80004005.

ExternalException usa a implementação padrão de Equals, que suporta a igualdade de referência.

Para obter uma lista de valores iniciais para uma instância de ExternalException, consulte os ExternalException construtores.

Construtores

Name Description
ExternalException()

Inicializa uma nova instância da ExternalException classe com propriedades por defeito.

ExternalException(SerializationInfo, StreamingContext)

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

ExternalException(String, Exception)

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

ExternalException(String, Int32)

Inicializa uma nova instância da ExternalException classe com uma mensagem de erro especificada e o HRESULT do erro.

ExternalException(String)

Inicializa uma nova instância da ExternalException classe com uma mensagem de erro especificada.

Propriedades

Name Description
Data

Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção.

(Herdado de Exception)
ErrorCode

Obtém o HRESULT erro do erro.

HelpLink

Obtém ou define um link para o ficheiro de ajuda associado a esta exceção.

(Herdado de Exception)
HResult

Recebe ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica.

(Herdado de Exception)
InnerException

Obtém a Exception instância que causou a exceção atual.

(Herdado de Exception)
Message

Recebe uma mensagem que descreve a exceção atual.

(Herdado de Exception)
Source

Obtém ou define o nome do aplicativo ou o objeto que causa o erro.

(Herdado de Exception)
StackTrace

Obtém uma representação string dos frames imediatos na stack de chamadas.

(Herdado de Exception)
TargetSite

Obtém o método que lança a exceção atual.

(Herdado de Exception)

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetBaseException()

Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes.

(Herdado de Exception)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Quando sobreposto numa classe derivada, define a SerializationInfo informação com sobre a exceção.

(Herdado de Exception)
GetType()

Obtém o tipo de execução da instância atual.

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma string que contém o HRESULT do erro.

ToString()

Cria e devolve uma representação string da exceção atual.

(Herdado de Exception)

evento

Name Description
SerializeObjectState

Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção.

(Herdado de Exception)

Aplica-se a

Ver também