Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase Win32Exception

 

Publicado: noviembre de 2016

Se produce una excepción para un código de error de Win32.

Espacio de nombres:   System.ComponentModel
Ensamblado:  System (en System.dll)

System.Object
  System.Exception
    System.SystemException
      System.Runtime.InteropServices.ExternalException
        System.ComponentModel.Win32Exception
          System.Net.HttpListenerException
          System.Net.NetworkInformation.NetworkInformationException
          System.Net.Sockets.SocketException
          System.Net.WebSockets.WebSocketException

[SerializableAttribute]
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public class Win32Exception : ExternalException, ISerializable

NombreDescripción
System_CAPS_pubmethodWin32Exception()

Inicializa una nueva instancia de la Win32Exception clase con el último error de Win32 que se ha producido.

System_CAPS_pubmethodWin32Exception(Int32)

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

System_CAPS_pubmethodWin32Exception(Int32, String)

Inicializa una nueva instancia de la Win32Exception descripción detallada de clase con el error especificado y el especificado.

System_CAPS_protmethodWin32Exception(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la Win32Exception clase con el contexto especificado y la información de serialización.

System_CAPS_pubmethodWin32Exception(String)

Inicializa una nueva instancia de la Win32Exception clase con la descripción detallada especificada.

System_CAPS_pubmethodWin32Exception(String, Exception)

Inicializa una nueva instancia de la Win32Exception clase con la descripción detallada especificada y la excepción especificada.

NombreDescripción
System_CAPS_pubpropertyData

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_pubpropertyErrorCode

Obtiene el elemento HRESULT del error.(Heredado de ExternalException).

System_CAPS_pubpropertyHelpLink

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

System_CAPS_pubpropertyHResult

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

System_CAPS_pubpropertyInnerException

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

System_CAPS_pubpropertyMessage

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

System_CAPS_pubpropertyNativeErrorCode

Obtiene el código de error Win32 asociado a esta excepción.

System_CAPS_pubpropertySource

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

System_CAPS_pubpropertyStackTrace

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

System_CAPS_pubpropertyTargetSite

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

NombreDescripción
System_CAPS_pubmethodEquals(Object)

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

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetBaseException()

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_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Establece la SerializationInfo objeto con el archivo nombre y número de línea en las que Win32Exception se ha producido.(Invalida Exception.GetObjectData(SerializationInfo, StreamingContext)).

System_CAPS_pubmethodGetType()

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

System_CAPS_protmethodMemberwiseClone()

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

System_CAPS_pubmethodToString()

Devuelve una cadena que contiene el valor HRESULT del error.(Heredado de ExternalException).

NombreDescripción
System_CAPS_proteventSerializeObjectState

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

Los códigos de error de Win32 se traducen desde sus representaciones numéricas en un mensaje del sistema cuando se muestran. Use NativeErrorCode para tener acceso a la representación numérica del código de error asociado a esta excepción. Para obtener más información acerca de los códigos de error, vea "Códigos de Error de Win32" en la documentación de Platform SDK en http://msdn.microsoft.com.

En el ejemplo de código siguiente se muestra cómo detectar una excepción de Win32 y se interpreta su contenido. En el ejemplo se intenta iniciar un archivo ejecutable inexistente, lo que produce una excepción de Win32. Tras detectar la excepción, el ejemplo obtiene el respectivo mensaje de error, el código y el origen de la excepción.

   try {
System.Diagnostics.Process myProc = new System.Diagnostics.Process();
myProc.StartInfo.FileName = "c:\nonexist.exe";  //Attempting to start a non-existing executable
myProc.Start();    //Start the application and assign it to the process component.    
   }
	    catch(Win32Exception w) {
Console.WriteLine(w.Message);
Console.WriteLine(w.ErrorCode.ToString());
Console.WriteLine(w.NativeErrorCode.ToString());
Console.WriteLine(w.StackTrace);
Console.WriteLine(w.Source);
Exception e=w.GetBaseException();
Console.WriteLine(e.Message);
    }

Plataforma universal de Windows
Disponible desde 10
.NET Framework
Disponible desde 1.1

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.

Volver al principio
Mostrar: