Clase ExternalException

 

Publicado: octubre de 2016

Tipo de excepción base para todas las excepciones de interoperabilidad COM y excepciones SEH (structured exception handling, control estructurado de excepciones).

Espacio de nombres:   System.Runtime.InteropServices
Ensamblado:  mscorlib (en mscorlib.dll)

Jerarquía de herencia

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

Sintaxis

[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

Constructores

	Nombre	Descripción
	ExternalException()	Inicializa una nueva instancia de la clase ExternalException con propiedades predeterminadas.
	ExternalException(SerializationInfo, StreamingContext)	Inicializa una nueva instancia de la ExternalException clase a partir de datos de serialización.
	ExternalException(String)	Inicializa una nueva instancia de la clase ExternalException con el mensaje de error especificado.
	ExternalException(String, Exception)	Inicializa una nueva instancia de la clase ExternalException con el mensaje de error especificado y una referencia a la excepción interna que representa la causa de esta excepción.
	ExternalException(String, Int32)	Inicializa una nueva instancia de la ExternalException clase con un mensaje de error especificado y el HRESULT del error.

Propiedades

	Nombre	Descripción
	Data	Obtiene una colección de pares clave-valor que proporcionan más información definida por el usuario sobre la excepción.(Heredado de Exception).
	ErrorCode	Obtiene el elemento HRESULT del error.
	HelpLink	Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción.(Heredado de Exception).
	HResult	Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica.(Heredado de Exception).
	InnerException	Obtiene la instancia Exception que produjo la excepción actual.(Heredado de Exception).
	Message	Obtiene un mensaje que describe la excepción actual.(Heredado de Exception).
	Source	Devuelve o establece el nombre de la aplicación o del objeto que generó el error.(Heredado de Exception).
	StackTrace	Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas.(Heredado de Exception).
	TargetSite	Obtiene el método que produjo la excepción actual.(Heredado de Exception).

Métodos

	Nombre	Descripción
	Equals(Object)	Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).
	Finalize()	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.(Heredado de Object).
	GetBaseException()	Cuando se invalida en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores.(Heredado de Exception).
	GetHashCode()	Sirve como la función hash predeterminada.(Heredado de Object).
	GetObjectData(SerializationInfo, StreamingContext)	Cuando se invalida en una clase derivada, establece SerializationInfo con información sobre la excepción.(Heredado de Exception).
	GetType()	Obtiene el tipo en tiempo de ejecución de la instancia actual.(Heredado de Exception).
	MemberwiseClone()	Crea una copia superficial del Object actual.(Heredado de Object).
	ToString()	Devuelve una cadena que contiene el valor HRESULT del error.(Invalida Exception.ToString()).

Eventos

	Nombre	Descripción
	SerializeObjectState	Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción.(Heredado de Exception).

Comentarios

To enhance interoperability between legacy systems and the common language runtime, the P:System.Runtime.InteropServices.ExternalException.ErrorCode property stores an integer value (HRESULT) that identifies the error. User defined exceptions should never derive from ExternalException, and an ExternalException should never be thrown by user code. Use the specific exceptions that derive from ExternalException instead.

ExternalException uses the HRESULT E_FAIL which has the value 0x80004005.

ExternalException uses the default Equals implementation, which supports reference equality.

For a list of initial values for an instance of ExternalException, see the ExternalException constructors.

Información de versión

.NET Framework
Disponible desde 1.1
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0

Seguridad para subprocesos

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Ver también

Exception
Espacio de nombres System.Runtime.InteropServices
Controlar y generar excepciones

Volver al principio