Compartir a través de


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
System_CAPS_pubmethod ExternalException()

Inicializa una nueva instancia de la clase ExternalException con propiedades predeterminadas.

System_CAPS_protmethod ExternalException(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la ExternalException clase a partir de datos de serialización.

System_CAPS_pubmethod ExternalException(String)

Inicializa una nueva instancia de la clase ExternalException con el mensaje de error especificado.

System_CAPS_pubmethod 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.

System_CAPS_pubmethod 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
System_CAPS_pubproperty 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).

System_CAPS_pubproperty ErrorCode

Obtiene el elemento HRESULT del error.

System_CAPS_pubproperty HelpLink

Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción.(Heredado de Exception).

System_CAPS_pubproperty HResult

Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica.(Heredado de Exception).

System_CAPS_pubproperty InnerException

Obtiene la instancia Exception que produjo la excepción actual.(Heredado de Exception).

System_CAPS_pubproperty Message

Obtiene un mensaje que describe la excepción actual.(Heredado de Exception).

System_CAPS_pubproperty Source

Devuelve o establece el nombre de la aplicación o del objeto que generó el error.(Heredado de Exception).

System_CAPS_pubproperty StackTrace

Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas.(Heredado de Exception).

System_CAPS_pubproperty TargetSite

Obtiene el método que produjo la excepción actual.(Heredado de Exception).

Métodos

Nombre Descripción
System_CAPS_pubmethod Equals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethod 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).

System_CAPS_pubmethod 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).

System_CAPS_pubmethod GetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethod GetObjectData(SerializationInfo, StreamingContext)

Cuando se invalida en una clase derivada, establece SerializationInfo con información sobre la excepción.(Heredado de Exception).

System_CAPS_pubmethod GetType()

Obtiene el tipo en tiempo de ejecución de la instancia actual.(Heredado de Exception).

System_CAPS_protmethod MemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethod ToString()

Devuelve una cadena que contiene el valor HRESULT del error.(Invalida Exception.ToString()).

Eventos

Nombre Descripción
System_CAPS_protevent 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