发送和接收错误

SOAP 错误将错误条件信息从服务传送到客户端，并且在双工情况下，将这些信息以互操作方式从客户端传送到服务。通常情况下，服务会定义自定义错误内容并指定可以返回错误的操作。（有关更多信息，请参见定义和指定错误。）本主题讨论在出现相应的错误条件时服务或双工客户端如何发送这些错误，以及客户端或服务应用程序如何处理这些错误。有关 Windows Communication Foundation (WCF) 应用程序中的错误处理的概述，请参见在协定和服务中指定和处理错误。

发送 SOAP 错误

声明的 SOAP 错误是指其中的某个操作具有 System.ServiceModel.FaultContractAttribute 的错误，该属性指定自定义 SOAP 错误类型。未声明的 SOAP 错误是指那些未在相应操作的协定中指定的错误。

发送已声明的错误

若要发送已声明的 SOAP 错误，需要检测与 SOAP 错误相对应的错误条件，并引发一个新的 System.ServiceModel.FaultException，其中类型参数是在该操作的 FaultContractAttribute 中指定的类型的新对象。下面的代码示例演示如何使用 FaultContractAttribute 来指定 SampleMethod 操作可以使用详细信息类型 GreetingFault 返回 SOAP 错误。

若要向客户端传送 GreetingFault 错误信息，需要捕捉相应的错误条件，并引发一个类型为 GreetingFault 的新 System.ServiceModel.FaultException，其参数为一个新的 GreetingFault 对象，如下面的代码示例所示。如果客户端是 WCF 客户端应用程序，它会将其视为托管异常，其中，异常类型是 GreetingFault 类型的 System.ServiceModel.FaultException。

发送未声明的错误

发送未声明的错误对于快速诊断和排除 WCF 应用程序中的问题而言非常有用，但是它作为调试工具的用处却很有限。一般来讲，在进行调试时，建议您使用 System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults 属性。在将此值设置为 true 时，客户端会将此类错误视为类型为 ExceptionDetail 的 FaultException 异常。

若要发送未声明的 SOAP 错误，会引发一个 System.ServiceModel.FaultException 对象（即，不是泛型类型 FaultException）并将该字符串传递给构造函数。它会作为一个已引发的 System.ServiceModel.FaultException 异常向 WCF 客户端应用程序公开，其中，可以通过调用 System.ServiceModel.FaultException.ToString 方法获得字符串。

处理错误

在 WCF 客户端中，客户端应用程序感兴趣的、在通信过程中发生的 SOAP 错误将作为托管异常引发。尽管在任何程序的执行过程中都可能发生许多异常，但使用 WCF 客户端编程模型的应用程序可以期望处理由通信问题引发的以下两种类型的异常。

• TimeoutException
• CommunicationException

当某个操作超过指定的超时期限时，引发 TimeoutException 对象。

当服务或客户端上存在某些可恢复的通信错误条件时，引发 CommunicationException 对象。

CommunicationException 类具有两个重要的派生类型：FaultException 和泛型 FaultException 类型。

当侦听器接收到操作协定中未预料到或未指定的错误时，引发 FaultException 异常；这通常在对应用程序进行调试并且服务的 System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults 属性设置为 true 时发生。

如果在对双向操作（即，一个具有 OperationContractAttribute 属性并将其 IsOneWay 设置为 false 的方法）进行响应时接收到操作协定中指定的错误，则会在客户端上引发 FaultException 异常。

通常，客户端和服务只对 FaultException、TimeoutException 和 CommunicationException 异常感兴趣。

按照正确的顺序捕捉错误异常

因为 FaultException 派生自 FaultException，而 FaultException 派生自 CommunicationException，所以按照正确的顺序捕捉这些异常非常重要。例如，如果您首先在 try/catch 块中捕捉 CommunicationException，则会在此块中处理所有已指定的和未指定的 SOAP 错误；用于处理自定义 FaultException 异常的任何后续 catch 块永远得不到调用。

请牢记，一个操作可以返回任意数量的指定错误。每个错误都具有唯一的类型，必须单独进行处理。

在关闭通道时处理异常

以上大多数讨论都与在处理应用程序消息（即，在客户端应用程序调用 WCF 客户端对象上的操作时由客户端显式发送的消息）期间发送的错误有关。

即使对于本地对象，释放对象也会引发或者屏蔽在回收过程中发生的异常。使用 WCF 客户端对象时，也可能发生类似的情况。当您调用操作时，您是在通过已建立的连接发送消息。如果无法完全关闭连接或连接已经关闭，那么即使所有操作都正确返回，关闭通道也会引发异常。

通常，客户端对象通道以下列方式之一关闭：

• 在回收 WCF 客户端对象时。
• 在客户端应用程序调用 System.ServiceModel.ClientBase.Close 时。
• 在客户端应用程序调用 System.ServiceModel.ICommunicationObject.Close 时。
• 在客户端应用程序调用会话的终止操作时。

在所有情况下，关闭通道都会指示通道开始关闭所有可能正在发送消息以支持应用程序级复杂功能的基础通道。例如，当协定需要使用会话时，绑定便会尝试通过与服务通道交换消息来建立会话，直到会话建立。当通道关闭时，基础会话通道会通知服务会话已终止。在此情况下，如果通道已经中止、关闭或由于其他原因（例如，网络电缆被拔出）而变得不可用，则客户端通道无法通知服务通道会话已终止，从而引发异常。

在需要时中止通道

因为关闭通道还会引发异常，所以，建议您除了按照正确的顺序捕捉错误异常以外，还需要在 catch 块中中止在进行调用时使用的通道。

如果错误传送了特定于某个操作的错误信息，并且其他操作仍有可能使用该通道，则无需中止该通道（尽管这种情况非常少见）。在其他所有情况下，都建议您中止该通道。有关演示上述所有要点的示例，请参见Expected Exceptions。

下面的代码示例演示如何在基本客户端应用程序中处理 SOAP 错误异常，包括已声明的错误和未声明的错误。

另请参见

参考

FaultException
FaultException
System.ServiceModel.CommunicationException

其他资源

Expected Exceptions
Avoiding Problems with the Using Statement