Classe ExternalException

 

Dica

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

Namespace:   System.Runtime.InteropServices
Assembly:  mscorlib (em mscorlib.dll)

Hierarquia de Herança

System.Object
  System.Exception
    System.SystemException
      System.Runtime.InteropServices.ExternalException
        Microsoft.JScript.Vsa.JSVsaException
        System.ComponentModel.Design.CheckoutException
        System.ComponentModel.Win32Exception
        System.Data.Common.DbException
        System.Messaging.MessageQueueException
        System.Runtime.InteropServices.COMException
        System.Runtime.InteropServices.SEHException
        System.ServiceModel.MsmqException
        System.Web.HttpException

Sintaxe

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class ExternalException : SystemException

[SerializableAttribute]
[ComVisibleAttribute(true)]
public ref class ExternalException : SystemException

[<SerializableAttribute>]
[<ComVisibleAttribute(true)>]
type ExternalException = 
    class
        inherit SystemException
    end

<SerializableAttribute>
<ComVisibleAttribute(True)>
Public Class ExternalException
    Inherits SystemException

Construtores

	Nome	Descrição
	ExternalException()	Inicializa uma nova instância da classe ExternalException com propriedades padrão.
	ExternalException(SerializationInfo, StreamingContext)	Inicializa uma nova instância da classe ExternalException dos dados de serialização.
	ExternalException(String)	Inicializa uma nova instância da classe ExternalException com uma mensagem de erro especificada.
	ExternalException(String, Exception)	Inicializa uma nova instância da classe ExternalException com uma mensagem de erro especificada e uma referência à exceção interna que é a causa da exceção.
	ExternalException(String, Int32)	Inicializa uma nova instância da classe ExternalException com uma mensagem de erro especificada e o HRESULT do erro.

Propriedades

	Nome	Descrição
	Data	Obtém uma coleção de pares de chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção.(Herdado de Exception.)
	ErrorCode	Obtém o HRESULT do 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 que é atribuído a uma exceção específica.(Herdado de Exception.)
	InnerException	Obtém a instância Exception 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 objeto que causa o erro.(Herdado de Exception.)
	StackTrace	Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas.(Herdado de Exception.)
	TargetSite	Obtém o método que gerou a exceção atual.(Herdado de Exception.)

Métodos

	Nome	Descrição
	Equals(Object)	Determina se o objeto especificado é igual ao objeto atual.(Herdado de Object.)
	Finalize()	Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.(Herdado de Object.)
	GetBaseException()	Quando substituído em uma classe derivada, retorna a Exception que é a 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)	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 tempo de execução da instância atual.(Herdado de Exception.)
	MemberwiseClone()	Cria uma cópia superficial do Object atual.(Herdado de Object.)
	ToString()	Retorna uma cadeia de caracteres que contém o HRESULT do erro.(Substitui o Exception.ToString().)

Eventos

	Nome	Descrição
	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.)

Comentários

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

ExternalExceptionusa o HRESULT E_FAIL que tem o valor 0x80004005.

ExternalExceptionusa o padrão Equals implementação, que oferece suporte a igualdade de referência.

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

Informações de Versão

.NET Framework
Disponível desde 1.1
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0

Acesso thread-safe

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Confira Também

Exception
Namespace System.Runtime.InteropServices
Manipulando e lançando exceções

Retornar ao início