MessageFault 類別

定義

public ref class MessageFault abstract

public abstract class MessageFault

type MessageFault = class

Public MustInherit Class MessageFault

繼承

Object

MessageFault

範例

以下範例展示了最常見的 。MessageFault 在 ProvideFaultHandleError 中 和 都傳遞 MessageFault 給一個可修改並回傳系統（在 ProvideFault的情況下）或用於執行某些自訂故障相關行為（在 HandleError的情況下）的物件。

在此範例中，方法 ProvideFault 會將所有 Exception 物件轉換成 MessageFault 包含 FaultException<TDetail> 的 GreetingFault 物件，並回傳該物件自訂 MessageFault 為 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

備註

每當你需要一個可修改並用來建立包含錯誤資訊的 SOAP 訊息的記憶體內 SOAP 錯誤時，都可以使用這個 MessageFault 類別。

通常，該 MessageFault 類別會在實作 IErrorHandler 介面時使用。 在這種情況下，Windows Communication Foundation（WCF）會傳遞 MessageFault 物件，你可以根據自己的需求使用它（例如，你可以自訂 MessageFault 或用來記錄故障資訊）。 然而，可以在 MessageFault 需要自訂 SOAP 錯誤訊息處理的地方使用。