MessageFault Classe

Définition

public ref class MessageFault abstract

public abstract class MessageFault

type MessageFault = class

Public MustInherit Class MessageFault

Héritage

Object

MessageFault

Exemples

L’exemple de code suivant montre l’utilisation la plus courante de MessageFault. À la fois le passage et la ProvideFault transmission d’un HandleError objet qui peut être modifié et retourné au système (dans le cas de MessageFault) ou utilisé pour effectuer un comportement personnalisé lié à une erreur (dans le cas de ProvideFault).HandleError

Dans cet exemple, la ProvideFault méthode convertit tous les Exception objets en objet MessageFault qui contient un FaultException<TDetail> objet de type GreetingFault et retourne cette valeur personnalisée MessageFault dans 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

Remarques

Utilisez la MessageFault classe chaque fois que vous avez besoin d’une erreur SOAP en mémoire qui peut être modifiée et utilisée pour créer un message SOAP qui contient les informations d’erreur.

En règle générale, la MessageFault classe est utilisée lors de l’implémentation de l’interface IErrorHandler . Dans ce cas, Windows Communication Foundation (WCF) transmet l’objet MessageFault et vous l’utilisez pour vos besoins spécifiques (par exemple, vous pouvez personnaliser le MessageFault ou consigner les informations d’erreur). Toutefois, MessageFault vous pouvez utiliser n’importe où la gestion personnalisée des messages d’erreur SOAP est requise.