MessageFault Klass

Definition

public ref class MessageFault abstract

public abstract class MessageFault

type MessageFault = class

Public MustInherit Class MessageFault

Arv

Object

MessageFault

Exempel

I följande kodexempel visas den vanligaste användningen av MessageFault. ProvideFault Både och HandleError skickar in ett MessageFault objekt som kan ändras och returneras till systemet (i fallet ProvideFaultmed ) eller som används för att utföra vissa anpassade felrelaterade beteenden (i fallet HandleErrormed ).

I det här exemplet ProvideFault konverterar metoden alla Exception objekt till ett MessageFault objekt som innehåller ett FaultException<TDetail> objekt av typen GreetingFault och returnerar det som är anpassat MessageFault till 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

Kommentarer

MessageFault Använd klassen när du behöver ett SOAP-fel i minnet som kan ändras och användas för att skapa ett SOAP-meddelande som innehåller felinformationen.

Vanligtvis MessageFault används klassen när gränssnittet implementeras IErrorHandler . I det här fallet skickar Windows Communication Foundation (WCF) objektet MessageFault och du använder det för dina specifika behov (du kan till exempel anpassa MessageFault eller logga felinformation). Kan dock MessageFault användas var som helst där anpassad SOAP-felmeddelandehantering krävs.