Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe FaultException

 

Representa uma falha SOAP.

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

System.Object
  System.Exception
    System.SystemException
      System.ServiceModel.CommunicationException
        System.ServiceModel.FaultException
          System.ServiceModel.FaultException<TDetail>
          System.ServiceModel.Web.WebFaultException

[SerializableAttribute]
public class FaultException : CommunicationException

NomeDescrição
System_CAPS_pubmethodFaultException()

Inicializa uma nova instância da classe FaultException.

System_CAPS_pubmethodFaultException(FaultReason)

Inicializa uma nova instância da classe FaultException usando o motivo especificado.

System_CAPS_pubmethodFaultException(FaultReason, FaultCode)

Inicializa uma nova instância da classe FaultException usando o motivo e o código de falha especificados.

System_CAPS_pubmethodFaultException(FaultReason, FaultCode, String)

Inicializa uma nova instância da classe FaultException usando o motivo especificado, código de falha e valor da ação.

System_CAPS_pubmethodFaultException(MessageFault)

Inicializa uma nova instância de FaultException classe usando os valores de falha de mensagem especificado.

System_CAPS_pubmethodFaultException(MessageFault, String)

Inicializa uma nova instância de FaultException classe usando os valores de falha de mensagem especificado e a cadeia de caracteres de ação fornecidos.

System_CAPS_protmethodFaultException(SerializationInfo, StreamingContext)

Inicializa uma nova instância do FaultException classe usando informações de serialização e contexto ao desserializar um fluxo em um FaultException objeto.

System_CAPS_pubmethodFaultException(String)

Inicializa uma nova instância de FaultException classe com o motivo da falha especificado.

System_CAPS_pubmethodFaultException(String, FaultCode)

Inicializa uma nova instância de FaultException classe usando o motivo especificado e o código de falha de SOAP.

System_CAPS_pubmethodFaultException(String, FaultCode, String)

Inicializa uma nova instância do FaultException usando o motivo especificado, o código de falha e o valor de ação de classe.

NomeDescrição
System_CAPS_pubpropertyAction

Obtém o valor da ação SOAP para a mensagem de falha.

System_CAPS_pubpropertyCode

Obtém o código com falha para a falha de SOAP.

System_CAPS_pubpropertyData

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

System_CAPS_pubpropertyHelpLink

Obtém ou define um link para o arquivo de ajuda associado a esta exceção.(Herdado de Exception.)

System_CAPS_pubpropertyHResult

Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica.(Herdado de Exception.)

System_CAPS_pubpropertyInnerException

Obtém a instância Exception que causou a exceção atual.(Herdado de Exception.)

System_CAPS_pubpropertyMessage

Obtém a mensagem da exceção.(Substitui o Exception.Message.)

System_CAPS_pubpropertyReason

Obtém o FaultReason para a falha de SOAP.

System_CAPS_pubpropertySource

Obtém ou define o nome do aplicativo ou do objeto que causa o erro. (Herdado de Exception.)

System_CAPS_pubpropertyStackTrace

Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas.(Herdado de Exception.)

System_CAPS_pubpropertyTargetSite

Obtém o método que gera a exceção atual.(Herdado de Exception.)

NomeDescrição
System_CAPS_pubmethodSystem_CAPS_staticCreateFault(MessageFault, String, Type[])

Retorna um FaultException objeto contra a falha de mensagem especificada, ação e uma matriz de tipos de detalhes.

System_CAPS_pubmethodSystem_CAPS_staticCreateFault(MessageFault, Type[])

Retorna um FaultException objeto contra a falha de mensagem especificada e uma matriz de tipos de detalhes.

System_CAPS_pubmethodCreateMessageFault()

Retorna um objeto MessageFault.

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodGetBaseException()

Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes.(Herdado de Exception.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Implementação de ISerializable.GetObjectData método é chamado quando o objeto é serializado em um fluxo.(Substitui o Exception.GetObjectData(SerializationInfo, StreamingContext).)

System_CAPS_pubmethodGetType()

Obtém o tipo em tempo de execução da instância atual. (Herdado de Exception.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_pubmethodToString()

Cria e retorna uma representação da cadeia de caracteres da exceção atual. (Herdado de Exception.)

NomeDescrição
System_CAPS_proteventSerializeObjectState

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

In a service, use the T:System.ServiceModel.FaultException class to create an untyped fault to return to the client for debugging purposes.

In a client, catch T:System.ServiceModel.FaultException objects to handle unknown or generic faults, such as those returned by a service with the P:System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults property set to true. Because T:System.ServiceModel.FaultException extends T:System.ServiceModel.CommunicationException, remember to catch any T:System.ServiceModel.FaultException objects prior to catching T:System.ServiceModel.CommunicationException objects if you want to catch them separately.

System_CAPS_noteObservação

Duplex services can also catch T:System.ServiceModel.FaultException objects returned from their interaction with a duplex client.

In general, it is strongly recommended that you use the T:System.ServiceModel.FaultContractAttribute to design your services to return strongly-typed SOAP faults (and not managed exception objects) for all fault cases in which you decide the client requires fault information. However, use the T:System.ServiceModel.FaultException in the following situations:

  • To send SOAP faults from a service for debugging purposes.

  • To catch SOAP faults on a client when the faults are not part of the service contract.

Throw T:System.ServiceModel.FaultException objects when you want the string to be passed to the constructor and retrieved by the client by calling the M:System.ServiceModel.FaultException`1.ToString method. If you specify a fault contract of type T:System.ServiceModel.FaultException`1 where the type parameter is T:System.String, the string value is available as the P:System.ServiceModel.FaultException`1.Detail property and not by calling M:System.ServiceModel.FaultException`1.ToString.

For details, see Handling Faults in Windows Communication Foundation Contracts.

The following code example shows the use of a try/catch block to catch and handle T:System.ServiceModel.FaultException objects thrown from a service. This often occurs when debugging is turned on in the service application.

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

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 3.0
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0

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

Retornar ao início
Mostrar: