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 FaultException

Representa uma falha SOAP.

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

[SerializableAttribute]
public class FaultException : CommunicationException

O tipo FaultException expõe os membros a seguir.

  NomeDescrição
Método públicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreFaultException()Inicializa uma nova instância da classe FaultException.
Método públicoFaultException(FaultReason)Inicializa uma nova instância da FaultException de classe usando o motivo especificado.
Método públicoFaultException(MessageFault)Inicializa uma nova instância da FaultException usando os valores de falha de mensagem especificada de classe.
Método públicoFaultException(String)Inicializa uma nova instância da FaultException classe com o motivo da falha especificado.
Método públicoFaultException(FaultReason, FaultCode)Inicializa uma nova instância da FaultException de classe usando o código de motivo e falhas especificado.
Método públicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreFaultException(MessageFault, String)Inicializa uma nova instância da FaultException usando os valores de falha de mensagem especificada e a seqüência de caracteres fornecida de ação de classe.
Método protegidoFaultException(SerializationInfo, StreamingContext)Inicializa uma nova instância da FaultException de classe usando as informações de serialização especificado e o contexto ao desserializar um fluxo em um FaultException objeto.
Método públicoFaultException(String, FaultCode)Inicializa uma nova instância da FaultException de classe usando o motivo especificado e o código de falha SOAP.
Método públicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreFaultException(FaultReason, FaultCode, String)Inicializa uma nova instância da FaultException usando o motivo especificado, o código de falha e o valor da ação de classe.
Método públicoFaultException(String, FaultCode, String)Inicializa uma nova instância da FaultException usando o motivo especificado, o código de falha e o valor da ação de classe.
Superior

  NomeDescrição
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreActionObtém o valor da ação SOAP para a mensagem de falha.
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreCodeObtém o código de falha para a falha SOAP.
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreData 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úblicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreHelpLinkObtém ou define um link para o arquivo de ajuda associado a esta exceção. (Herdado de Exception.)
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreHResultObtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception.)
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreInnerExceptionObtém a instância de Exception que causou a exceção atual. (Herdado de Exception.)
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreMessageObtém a mensagem da exceção. (Substitui Exception.Message.)
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreReasonObtém o FaultReason da falha de SOAP.
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreSource Obtém ou define o nome do aplicativo ou do objeto que causa o erro. (Herdado de Exception.)
Propriedade públicaCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreStackTraceObtém uma representação de cadeia de caracteres de peças imediatos na pilha de chamadas. (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úblicoMembro estáticoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreCreateFault(MessageFault, Type[])Retorna um FaultException objeto a partir de uma matriz de tipos de detalhes e de falha de mensagem especificada.
Método públicoMembro estáticoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreCreateFault(MessageFault, String, Type[])Retorna um FaultException objeto contra a falha de mensagem especificada, a ação e uma matriz de tipos de detalhes.
Método públicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreCreateMessageFaultRetorna um MessageFault objeto.
Método públicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegidoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreFinalize 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úblicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetBaseException 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úblicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetObjectDataImplementação da ISerializable.GetObjectData método que é chamado quando o objeto é serializado em um fluxo. (Substitui Exception.GetObjectData(SerializationInfo, StreamingContext).)
Método públicoGetType Obtém o tipo em tempo de execução da instância atual. (Herdado de Exception.)
Método protegidoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método públicoCom suporte por Biblioteca de Classes PortátilCom suporte em .NET para aplicativos da Windows StoreToString Cria e retorna uma representação da cadeia de caracteres da exceção atual. (Herdado de Exception.)
Superior

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

Em um serviço, use o FaultException classe para criar uma falha sem tipo, para retornar ao cliente para fins de depuração.

Em um cliente, catch FaultException objetos para lidar com falhas desconhecidas ou genéricas, tais como aqueles retornados por um serviço com o IncludeExceptionDetailInFaults propriedade definida como true. Porque FaultException estende CommunicationException, lembre-se de capturar qualquer FaultException objetos antes da captura de CommunicationException objetos que se deseja capturá-las separadamente.

ObservaçãoObservação

Serviços duplex também podem capturar FaultException objetos retornados de sua interação com um cliente duplex.

Em geral, é altamente recomendável que você use o FaultContractAttribute para projetar seus serviços para retornar as falhas SOAP com rigidez de tipos (e objetos de exceção não gerenciado) para todos os casos em que você decida o cliente requer informações sobre a falha de falhas. No entanto, usar o FaultException nas seguintes situações:

  • Para enviar as falhas SOAP de um serviço para fins de depuração.

  • Para detectar falhas SOAP em um cliente quando as falhas não são parte do contrato de serviço.

Lançar FaultException objetos quando você deseja que a seqüência de caracteres a ser passado para o construtor e recuperados pelo cliente, chamando o FaultException<TDetail>.ToString método. Se você especificar um contrato de falha do tipo System.ServiceModel.FaultException<TDetail> onde o parâmetro de tipo é System.String, o valor de seqüência de caracteres está disponível como o FaultException<TDetail>.Detail propriedade e não chamando FaultException<TDetail>.ToString.

Para obter detalhes, consulte:Especificando e tratando falhas nos contratos e serviços.

O exemplo de código a seguir mostra o uso de um bloco try/catch para capturar e manipular FaultException objetos lançados de um serviço. Isso ocorre geralmente quando a depuração está ativada no aplicativo de serviço.


using System;
using System.ServiceModel;
using System.ServiceModel.Channels;
using Microsoft.WCF.Documentation;

public class Client
{
  public static void Main()
  {
    // Picks up configuration from the configuration file.
    SampleServiceClient wcfClient = new SampleServiceClient();
    try
    {
      // Making calls.
      Console.WriteLine("Enter the greeting to send: ");
      string greeting = Console.ReadLine();
      Console.WriteLine("The service responded: " + wcfClient.SampleMethod(greeting));
      Console.WriteLine("Press ENTER to exit:");
      Console.ReadLine();
    }
    catch (TimeoutException timeProblem)
    {
      Console.WriteLine("The service operation timed out. " + timeProblem.Message);
      wcfClient.Abort();
      Console.ReadLine();
    }
    // Catch the contractually specified SOAP fault raised here as an exception.
    catch (FaultException<GreetingFault> greetingFault)
    {
      Console.WriteLine(greetingFault.Detail.Message);
      Console.Read();
      wcfClient.Abort();
    }
    // Catch unrecognized faults. This handler receives exceptions thrown by WCF
    // services when ServiceDebugBehavior.IncludeExceptionDetailInFaults 
    // is set to true.
    catch (FaultException faultEx)
    {
      Console.WriteLine("An unknown exception was received. " 
        + faultEx.Message
        + faultEx.StackTrace
      );
      Console.Read();
      wcfClient.Abort();
    }
    // Standard communication fault handler.
    catch (CommunicationException commProblem)
    {
      Console.WriteLine("There was a communication problem. " + commProblem.Message + commProblem.StackTrace);
      Console.Read();
      wcfClient.Abort();
    }
  }
}


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, 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.

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft