MessageFault Klas

Definitie

public ref class MessageFault abstract

public abstract class MessageFault

type MessageFault = class

Public MustInherit Class MessageFault

Overname

Object

MessageFault

Voorbeelden

In het volgende codevoorbeeld ziet u het meest voorkomende gebruik van MessageFault. Zowel het ProvideFault object als HandleError het doorgeven van een MessageFault object dat kan worden gewijzigd en geretourneerd aan het systeem (in het geval van ProvideFault) of wordt gebruikt om een aangepast gedrag met betrekking tot fouten uit te voeren (in het geval van HandleError).

In dit voorbeeld converteert de ProvideFault methode alle Exception objecten naar een MessageFault object dat een object van het FaultException<TDetail> type GreetingFault bevat en retourneert die zijn aangepast MessageFault aan 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

Opmerkingen

Gebruik de MessageFault klasse op elk moment dat u een SOAP-fout in het geheugen nodig hebt die kan worden gewijzigd en gebruikt om een SOAP-bericht te maken dat de foutinformatie bevat.

Normaal gesproken wordt de MessageFault klasse gebruikt bij het implementeren van de IErrorHandler interface. In dit geval geeft Windows Communication Foundation (WCF) het MessageFault-object door en gebruikt u het voor uw specifieke behoeften (u kunt bijvoorbeeld de MessageFault aanpassen of foutgegevens vastleggen). U MessageFault kunt echter overal worden gebruikt waar aangepaste SOAP-foutberichten worden verwerkt.