MessageFault Klasse

Definition

public ref class MessageFault abstract

public abstract class MessageFault

type MessageFault = class

Public MustInherit Class MessageFault

Vererbung

Object

MessageFault

Beispiele

Das folgende Codebeispiel zeigt die am häufigsten verwendete Verwendung von MessageFault. Sowohl das ProvideFaultHandleError Objekt als auch das Übergeben, MessageFault das geändert und an das System zurückgegeben werden kann (im Fall von ProvideFault) oder verwendet, um ein benutzerdefiniertes fehlerbezogenes Verhalten auszuführen (im Fall von HandleError).

In diesem Beispiel konvertiert die ProvideFault Methode alle Exception Objekte in ein MessageFault Objekt, das ein FaultException<TDetail> Objekt vom Typ GreetingFault enthält, und gibt diese an WCF angepasst MessageFault zurück.

#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

Hinweise

Verwenden Sie die MessageFault Klasse jedes Mal, wenn Sie einen SOAP-Fehler im Arbeitsspeicher benötigen, der geändert und verwendet werden kann, um eine SOAP-Nachricht zu erstellen, die die Fehlerinformationen enthält.

In der Regel wird die MessageFault Klasse beim Implementieren der IErrorHandler Schnittstelle verwendet. In diesem Fall übergibt Windows Communication Foundation (WCF) das MessageFault-Objekt, und Sie verwenden es für Ihre spezifischen Anforderungen (z. B. können Sie die MessageFault anpassen oder Fehlerinformationen protokollieren). Es kann jedoch überall verwendet werden, MessageFault wo eine benutzerdefinierte SOAP-Fehlernachrichtenbehandlung erforderlich ist.