MessageFault Classe

Definizione

public ref class MessageFault abstract

public abstract class MessageFault

type MessageFault = class

Public MustInherit Class MessageFault

Ereditarietà

Object

MessageFault

Esempio

Nell'esempio di codice seguente viene illustrato l'uso più comune di MessageFault. Sia che ProvideFaultHandleError passano un MessageFault oggetto che può essere modificato e restituito al sistema (nel caso di ProvideFault) o usato per eseguire un comportamento personalizzato correlato all'errore (nel caso di HandleError).

In questo esempio, il ProvideFault metodo converte tutti gli Exception oggetti in un MessageFault oggetto contenente un FaultException<TDetail> oggetto di tipo GreetingFault e restituisce tale oggetto personalizzato MessageFault in 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

Commenti

Usare la MessageFault classe ogni volta che è necessario un errore SOAP in memoria che può essere modificato e usato per creare un messaggio SOAP contenente le informazioni sull'errore.

In genere, la MessageFault classe viene usata quando si implementa l'interfaccia IErrorHandler . In questo caso, Windows Communication Foundation (WCF) passa l'oggetto MessageFault e lo si usa per esigenze specifiche( ad esempio, è possibile personalizzare il MessageFault o registrare le informazioni sull'errore). Tuttavia, MessageFault può essere usato ovunque sia necessaria la gestione personalizzata dei messaggi di errore SOAP.