服务调试行为

ServiceDebug 示例演示如何配置服务调试行为设置。 此示例基于名为Getting Started的指南，并实现ICalculator服务协定。 此示例在配置文件中显式定义服务调试行为。 也可以在代码中命令性地完成。

在此示例中，客户端是一个控制台应用程序 (.exe)，服务是由 Internet 信息服务 (IIS) 承载的。

服务器的 Web.config 文件定义服务调试行为，以启用帮助页和异常处理，如以下示例所示。

<behaviors>
     <serviceBehaviors>
         <behavior name="CalculatorServiceBehavior">
         <!-- WARNING: Setting includeExceptionDetailInFaults = "True" could result in leaking secured server information to the client.-->
         <!-- Please set this to false when deploying -->
             <serviceDebug includeExceptionDetailInFaults="True" httpHelpPageEnabled="True"/>
         </behavior>
     </serviceBehaviors>
</behaviors>

<serviceDebug> 是允许更改服务调试行为属性的配置元素。 用户可以修改此行为以实现以下目的：

• 这允许服务返回应用程序代码引发的任何异常，即使未使用 </gt; 声明异常。 通过将 includeExceptionDetailInFaults 设置为 true。 当调试服务器引发意外异常的情况时，此设置非常有用。

  重要

  在生产环境中启用此设置并不安全。 意外的服务器异常可能包含一些不适合客户端的信息，因此将 includeExceptionDetailsInFaults 设置为 true 可能会导致信息泄漏。

• serviceDebug<> 还允许用户启用或禁用帮助页。 每个服务可以选择公开一个帮助页，其中包含有关服务的信息，包括用于获取服务的 WSDL 的终结点。 可以通过将 httpHelpPageEnabled 设置为 true 来启用该功能。 这使得在服务基址接收到 GET 请求时能够返回帮助页。 可以通过设置另一个属性 httpHelpPageUrl来更改此地址。 可以使用 HTTPS 而不是 HTTP 来保护此安全。 可以通过设置 httpsHelpPageEnabled 和 httpsHelpPageUrl。

运行示例时，操作请求和响应将显示在客户端控制台窗口中。 前三个操作（加法、减法和乘法）必须成功。 最后一个操作（“除”）由于除数为零异常而失败。

设置、生成和运行示例

1. 确保已为 Windows Communication Foundation 示例 执行One-Time 安装过程。

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

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