Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe Win32Exception

Lança uma exceção para um código de erro Win32.

Namespace:  System.ComponentModel
Assembly:  System (em System.dll)

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

O tipo Win32Exception expõe os membros a seguir.

  NomeDescrição
Método públicoCompatível com o XNA FrameworkWin32Exception()Inicializa uma nova instância da Win32Exception classe com o último erro do Win32 que ocorreu.
Método públicoCompatível com o XNA FrameworkWin32Exception(Int32)Inicializa uma nova instância da Win32Exception classe com o erro especificado.
Método públicoWin32Exception(String)Inicializa uma nova instância da Win32Exception classe com a descrição detalhada especificada.
Método públicoCompatível com o XNA FrameworkWin32Exception(Int32, String)Inicializa uma nova instância da Win32Exception descrição detalhada da classe com o erro especificado e o especificado.
Método protegidoWin32Exception(SerializationInfo, StreamingContext)Inicializa uma nova instância da Win32Exception classe com o contexto especificado e as informações de serialização.
Método públicoWin32Exception(String, Exception)Inicializa uma nova instância da Win32Exception classe com a descrição detalhada especificada e a exceção especificada.
Superior

  NomeDescrição
Propriedade públicaData Obtém uma coleção de pares chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção. (Herdado de Exception.)
Propriedade públicaCompatível com o XNA FrameworkErrorCodeObtém o HRESULT do erro. (Herdado de ExternalException.)
Propriedade públicaHelpLinkObtém ou define um link para o arquivo de ajuda associado a esta exceção. (Herdado de Exception.)
Propriedade públicaCompatível com o XNA FrameworkHResultObtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception.)
Propriedade públicaCompatível com o XNA FrameworkInnerExceptionObtém a instância de Exception que causou a exceção atual. (Herdado de Exception.)
Propriedade públicaCompatível com o XNA FrameworkMessageRecebe uma mensagem que descreve a exceção atual. (Herdado de Exception.)
Propriedade públicaCompatível com o XNA FrameworkNativeErrorCodeObtém o código de erro Win32 associado a essa exceção.
Propriedade públicaSource Obtém ou define o nome do aplicativo ou do objeto que causa o erro. (Herdado de Exception.)
Propriedade públicaCompatível com o XNA FrameworkStackTraceObtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamada. (Herdado de Exception.)
Propriedade públicaTargetSiteObtém o método que gera a exceção atual. (Herdado de Exception.)
Superior

  NomeDescrição
Método públicoCompatível com o XNA FrameworkEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoCompatível com o XNA FrameworkFinalize Permite um objeto tentar liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoCompatível com o XNA FrameworkGetBaseException Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception.)
Método públicoCompatível com o XNA FrameworkGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetObjectDataConjuntos de SerializationInfo o objeto com o número de linha e o nome do arquivo no qual este Win32Exception ocorreu. (Substitui Exception.GetObjectData(SerializationInfo, StreamingContext).)
Método públicoCompatível com o XNA FrameworkGetType Obtém o tipo em tempo de execução da instância atual. (Herdado de Exception.)

In XNA Framework 3.0, esse membro é herdado de Object.GetType().
Método protegidoCompatível com o XNA FrameworkMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método públicoCompatível com o XNA FrameworkToStringRetorna um string que contém o HRESULT do erro. (Herdado de ExternalException.)

In XNA Framework, esse membro é substituído por ToString().
Superior

  NomeDescrição
Evento protegidoSerializeObjectStateOcorre quando uma exceção for serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception.)
Superior

Códigos de erro Win32 são traduzidos de suas representações numéricas em uma mensagem do sistema quando elas são exibidas. Use NativeErrorCode para acessar a representação numérica do código de erro associado a essa exceção. Para obter mais informações sobre os códigos de erro, consulte "Win32 Error Codes" na documentação do Platform SDK em http://msdn.microsoft.com.

ObservaçãoObservação

O atributo HostProtectionAttribute aplicado a este tipo ou membro tem o seguinte Resources valor de propriedade: SharedState. O HostProtectionAttribute não afeta aplicativos de área de trabalho (que são normalmente iniciados com o clique duplo em um ícone, a digitação de um comando ou a inserção de uma URL em um navegador). Para obter mais informações, consulte a classe HostProtectionAttribute ou Programação em SQL Server e atributos de proteção de host.

O exemplo de código a seguir mostra como capturar uma exceção do Win32 e interpretar seu conteúdo. O exemplo tenta iniciar um executável não existente, o que resulta em uma exceção do Win32. Após a captura a exceção, o exemplo de busca a mensagem de erro respectivos, o código e a origem da exceção.


	    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);
 	    }


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Qualquer estático (Shared no Visual Basic) membro público desse tipo é thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft