当前位置 博文首页 > 流浪若相惜的专栏:配置跟踪开关

    流浪若相惜的专栏:配置跟踪开关

    作者:[db:作者] 时间:2021-08-01 08:38


    转自:msdn

    在分发应用程序后,仍然可以通过配置应用程序中的跟踪开关来启用或禁用跟踪输出。配置开关意味着在开关初始化后通过外部源来更改它的值。您可以使用配置文件来更改开关对象的值。通过配置跟踪开关,可以将其打开和关闭或设置其级别,以确定它向侦听器传递的消息量及消息类型。

    您可以使用 .config 文件来配置开关。对于 Web 应用程序,该文件是与项目相关联的 Web.config 文件。对于 Windows 应用程序,它是命名的(应用程序名称).exe.config。在已部署的应用程序中,该文件必须驻留在与可执行文件相同的文件夹中。

    当应用程序首次执行将创建开关实例的代码时,它将在配置文件中检查有关命名开关的跟踪级别信息。对于任一特定的开关,跟踪系统只检查一次配置文件,即当应用程序首次创建开关时进行检查。

    在已部署的应用程序中,当应用程序未运行时,可以通过重新配置开关对象来启用跟踪代码。通常,此过程包括打开和关闭开关对象或更改跟踪级别,然后重新启动应用程序。

    当创建开关的实例时,也可通过指定以下两个参数将其初始化:displayName?参数和?description?参数。构造函数的?displayName?参数设置了?Switch类实例的?Switch.DisplayName?属性。displayName?是一个名称,用于在 .config 文件中配置开关,而?description?参数应返回开关的简要说明以及它所控制的消息类型。

    除了指定要配置的开关的名称之外,还必须指定开关的值。该值为整数。对于?BooleanSwitch,值 0 对应于?Off,任何非零值都对应于?On。对于TraceSwitch,0、1、2、3 和 4 分别对应于?OffErrorWarningInfo?和?Verbose。任何大于 4 的数字都会被当作?Verbose,任何小于零的数字都会被当作?Off

    为了使最终用户能够配置应用程序的跟踪开关,必须提供有关应用程序中开关的详细文档。您应该详细说明每个开关的用途以及如何打开和关闭每个开关。您还应该向最终用户提供一个在注释中包含相应帮助的 .config 文件。

    创建和配置跟踪开关

    1. 在代码中创建开关。有关更多信息,请参见创建并初始化跟踪开关。
    2. 如果项目中没有包含配置文件(app.config 或 Web.config),请从“项目”菜单中选择“添加新项”。
      • Visual Basic:在“添加新项”对话框中选择“应用程序配置文件”。

        此时将创建并打开应用程序配置文件。它是一个根元素为 <configuration> 的 XML 文档。

      • Visual C#:在“添加新项”对话框中选择“XML 文件”。将此文件命名为 app.config。在 XML 编辑器中,在 XML 声明后添加以下 XML:cs
    下一篇:没有了