MessageFault Classe

Definição

public ref class MessageFault abstract

public abstract class MessageFault

type MessageFault = class

Public MustInherit Class MessageFault

Herança

Object

MessageFault

Derivado

System.ServiceModel.Channels.XmlObjectSerializerFault

Exemplos

O exemplo de código a seguir mostra o uso mais comum de MessageFault. ProvideFaultHandleError E passam um MessageFault objeto que pode ser modificado e retornado para o sistema (no caso de ProvideFault) ou usado para executar algum comportamento personalizado relacionado a falhas (no caso de HandleError).

Neste exemplo, o ProvideFault método converte todos os Exception objetos em um MessageFault objeto que contém um FaultException<TDetail> objeto do tipo GreetingFault e retorna que é personalizado MessageFault para o WCF.

#region IErrorHandler Members
public bool HandleError(Exception error)
{
  Console.WriteLine("HandleError called.");
  // Returning true indicates you performed your behavior.
  return true;
}

// This is a trivial implementation that converts Exception to FaultException<GreetingFault>.
public void ProvideFault(
  Exception error,
  MessageVersion ver,
  ref Message msg
)
{
  Console.WriteLine("ProvideFault called. Converting Exception to GreetingFault....");
  FaultException<GreetingFault> fe
    = new FaultException<GreetingFault>(new GreetingFault(error.Message));
  MessageFault fault = fe.CreateMessageFault();
  msg = Message.CreateMessage(
    ver,
    fault,
    "http://microsoft.wcf.documentation/ISampleService/SampleMethodGreetingFaultFault"
  );
}
#endregion

#Region "IErrorHandler Members"
Public Function HandleError(ByVal [error] As Exception) As Boolean Implements IErrorHandler.HandleError
  Console.WriteLine("HandleError called.")
  ' Returning true indicates you performed your behavior.
  Return True
End Function

' This is a trivial implementation that converts Exception to FaultException<GreetingFault>.
Public Sub ProvideFault(ByVal [error] As Exception, ByVal ver As MessageVersion, ByRef msg As Message) Implements IErrorHandler.ProvideFault
  Console.WriteLine("ProvideFault called. Converting Exception to GreetingFault....")
  Dim fe As New FaultException(Of GreetingFault)(New GreetingFault([error].Message))
  Dim fault As MessageFault = fe.CreateMessageFault()
  msg = Message.CreateMessage(ver, fault, "http://microsoft.wcf.documentation/ISampleService/SampleMethodGreetingFaultFault")
End Sub
#End Region

Comentários

Use a MessageFault classe sempre que precisar de uma falha SOAP na memória que possa ser modificada e usada para criar uma mensagem SOAP que contenha as informações de falha.

Normalmente, a MessageFault classe é usada ao implementar a IErrorHandler interface . Nesse caso, o WCF (Windows Communication Foundation) passa o objeto e você o MessageFault usa para suas necessidades específicas (por exemplo, você pode personalizar ou MessageFault registrar informações de falha). No entanto, MessageFault pode ser usado em qualquer lugar em que o tratamento de mensagens de falha SOAP personalizado é necessário.

Construtores

Propriedades

Métodos

Aplica-se a