大网数据广告活动
.NET 与 C# 开发

错误协定

· 52CE 我爱测

“错误协定”示例演示如何将错误信息从服务传达到客户端。 示例基于Getting Started,并且一些附加代码添加到服务,以便将内部异常转换为错误。 客户端试图执行除数为零的运算以在服务上强制产生错误情况。

“错误协定”示例演示如何将错误信息从服务传达到客户端。 示例基于Getting Started,并且一些附加代码添加到服务,以便将内部异常转换为错误。 客户端试图执行除数为零的运算以在服务上强制产生错误情况。

Note: 本主题的最后介绍了此示例的设置过程和生成说明。

已将计算器协定修改为包括 xref:System.ServiceModel.FaultContractAttribute,如下面的示例代码所示。

[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
public interface ICalculator  
{  
    [OperationContract]  
    int Add(int n1, int n2);  
    [OperationContract]  
    int Subtract(int n1, int n2);  
    [OperationContract]  
    int Multiply(int n1, int n2);  
    [OperationContract]  
    [FaultContract(typeof(MathFault))]  
    int Divide(int n1, int n2);  
}  

xref:System.ServiceModel.FaultContractAttribute 属性指示 Divide 运算可能返回一个 MathFault 类型的错误。 错误可以是可序列化的任何类型。 在本例中,MathFault 为数据协定,如下所示:

[DataContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
public class MathFault  
{      
    private string operation;  
    private string problemType;  
  
    [DataMember]  
    public string Operation  
    {  
        get { return operation; }  
        set { operation = value; }  
    }  
  
    [DataMember]          
    public string ProblemType  
    {  
        get { return problemType; }  
        set { problemType = value; }  
    }  
}  

如下面的示例代码所示,发生除数为零异常时,Divide 方法引发 xref:System.ServiceModel.FaultException`1 异常。 此异常导致向客户端发送一个错误。

public int Divide(int n1, int n2)  
{  
    try  
    {  
        return n1 / n2;  
    }  
    catch (DivideByZeroException)  
    {  
        MathFault mf = new MathFault();  
        mf.operation = "division";  
        mf.problemType = "divide by zero";  
        throw new FaultException<MathFault>(mf);  
    }  
}  

通过请求除数为零,客户端代码强制产生错误。 运行示例时,操作请求和响应将显示在客户端控制台窗口中。 您会看到将除数为零报告为错误。 在客户端窗口中按 Enter 可以关闭客户端。

Add(15,3) = 18  
Subtract(145,76) = 69  
Multiply(9,81) = 729  
FaultException<MathFault>: Math fault while doing division. Problem: divide by zero  
  
Press <ENTER> to terminate client.  

客户端通过捕获相应 FaultException<MathFault> 异常来完成此操作:

catch (FaultException<MathFault> e)  
{  
    Console.WriteLine("FaultException<MathFault>: Math fault while doing " + e.Detail.operation + ". Problem: " + e.Detail.problemType);  
    client.Abort();  
}  

默认情况下,不可预期的异常的详细信息不发送到客户端,以防止服务实现的详细信息泄露出服务的安全边界。 FaultContract 提供一种方法来描述协定中的故障并将某些类型的异常标记为适合传输到客户端。 FaultException<T> 提供了用于向使用者发送故障的运行时机制。

但是,在调试时查看服务失败的内部详细信息很有用。 若要关闭上述安全行为,您可以指示在发送到客户端的错误中必须包括服务器上每个未处理的异常的详细信息。 这是通过将 xref:System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults* 设置为 true 来完成的。 你可以在代码中或在配置中设置它,如下面的示例所示。

<behaviors>  
  <serviceBehaviors>  
    <behavior name="CalculatorServiceBehavior">  
      <serviceMetadata httpGetEnabled="True"/>  
      <serviceDebug includeExceptionDetailInFaults="True" />  
    </behavior>  
  </serviceBehaviors>  
</behaviors>  

此外,行为必须与服务关联的设置behaviorConfiguration属性为"CalculatorServiceBehavior"的配置文件中的服务。

若要在客户端上捕获这样的错误,必须捕获非泛型 xref:System.ServiceModel.FaultException。

此行为仅用于调试目的,切勿在生产中启用它。

设置、生成和运行示例

  1. 请确保您具有执行的 Windows Communication Foundation 示例的一次性安装过程。

  2. 若要生成 C# 或 Visual Basic .NET 版本的解决方案,请按照 Building the Windows Communication Foundation Samples中的说明进行操作。

  3. 若要在单或跨计算机配置中运行示例,请按照中的说明运行 Windows Communication Foundation 示例。

Important: 您的计算机上可能已安装这些示例。 在继续操作之前,请先检查以下(默认)目录:

<InstallDrive>:\WF_WCF_Samples

如果此目录不存在,请转到Windows Communication Foundation (WCF) 和.NET Framework 4 的 Windows Workflow Foundation (WF) 示例若要下载所有 Windows Communication Foundation (WCF) 和WF示例。 此示例位于以下目录:

<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Service\Faults

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。