Partilhar via

ExternalException Classe

Definição

Namespace:
System.Runtime.InteropServices
Assemblies:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
ExternalException.cs
Origem:
ExternalException.cs
Origem:
ExternalException.cs
Origem:
ExternalException.cs
Origem:
ExternalException.cs

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

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

Comentários

Para melhorar a interoperabilidade entre sistemas herdados e o common language runtime, a ErrorCode propriedade armazena um HRESULT (valor inteiro) que identifica o erro. As exceções definidas pelo usuário nunca devem derivar ExternalExceptione nunca ExternalException devem ser geradas pelo código do usuário. Use as exceções específicas das ExternalException quais derivam.

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

ExternalException usa a implementação padrão Equals , que dá suporte à igualdade de referência.

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

Construtores

Nome Description
ExternalException()

Inicializa uma nova instância da ExternalException classe com propriedades padrão.
ExternalException(SerializationInfo, StreamingContext)
Obsoleto.

Inicializa uma nova instância da classe a ExternalException 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

Nome Description
Data

Obtém uma coleção de pares chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção.

(Herdado de Exception)
ErrorCode

Obtém o HRESULT erro.
HelpLink

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

(Herdado de Exception)
HResult

Obtém 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

Obtém uma mensagem que descreve a exceção atual.

(Herdado de Exception)
Source

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

(Herdado de Exception)
StackTrace

Obtém uma representação de cadeia de caracteres dos quadros imediatos na pilha de chamadas.

(Herdado de Exception)
TargetSite

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

(Herdado de Exception)

Métodos

Nome Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetBaseException()

Quando substituído em uma classe derivada, retorna a Exception causa raiz de uma ou mais exceções subsequentes.

(Herdado de Exception)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)
Obsoleto.

Quando substituído em uma classe derivada, define o SerializationInfo com informações sobre a exceção.

(Herdado de Exception)
GetType()

Obtém o tipo de runtime da instância atual.

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que contém o HRESULT do erro.
ToString()

Cria e retorna uma representação de cadeia de caracteres da exceção atual.

(Herdado de Exception)

Eventos

Nome Description
SerializeObjectState
Obsoleto.

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

Confira também