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