PresentationTraceSources 类

定义

命名空间:

System.Diagnostics

程序集:

WindowsBase.dll

提供专门针对 Windows Presentation Foundation (WPF) 应用程序的调试跟踪支持。

public ref class PresentationTraceSources abstract sealed

public static class PresentationTraceSources

type PresentationTraceSources = class

Public Class PresentationTraceSources

继承

Object

PresentationTraceSources

示例

以下示例配置文件启用动画跟踪，并将输出写入名为“debug.txt”的文本文件。 此配置文件只能与 .NET Framework 应用一起使用。

<configuration>
  <system.diagnostics>
    <sources>
      <source name="System.Windows.Media.Animation"
switchName="SourceSwitch" >
        <listeners>
          <add name="textListener" />
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="SourceSwitch" value="All" />
    </switches>
    <sharedListeners>
      <add name="textListener"
           type="System.Diagnostics.TextWriterTraceListener"
           initializeData="Debug.txt" />
    </sharedListeners>
    <trace autoflush="true" indentsize="4"></trace>
  </system.diagnostics>
</configuration>

注解

仅当 WPF 应用程序在完全信任模式下运行时，调试跟踪才可用。

若要启用跟踪，首先必须设置注册表项，然后必须配置跟踪源。

• 若要创建注册表项，请在“HKeyCurrentUser\Software\Microsoft\Tracing\WPF”下将reg_dword值设置为 ManagedTracing 1。

• 若要在 .NET Framework 应用中配置跟踪源，请创建应用程序配置文件。 此文件的扩展名为 .config，例如 XamlPad.exe.config。

若要获得最佳应用程序性能，需要在应用程序设计中具有前所思念，并了解Windows Presentation Foundation (WPF) 应用程序开发的最佳做法。 有关详细信息，请参阅 优化 WPF 应用程序性能。

字段

TraceLevelProperty

标识 TraceLevel 附加属性。

属性

AnimationSource	获取动画跟踪源。
DataBindingSource	获取数据绑定跟踪源。
DependencyPropertySource	获取依赖属性跟踪源。
DocumentsSource	获取文档跟踪源。
FreezableSource	获取 Freezable 跟踪源。
HwndHostSource	获取 hwnd 宿主跟踪源。
MarkupSource	获取标记跟踪源。
NameScopeSource	获取名称范围跟踪源。
ResourceDictionarySource	获取资源字典跟踪源。
RoutedEventSource	获取路由事件跟踪源。
ShellSource	获取 shell 跟踪源。

附加属性

TraceLevel

提供专门针对 Windows Presentation Foundation (WPF) 应用程序的调试跟踪支持。

方法

GetTraceLevel(Object)	获取指定元素的 TraceLevel 附加属性值。
Refresh()	通过强制重新读取 app.config 文件来刷新跟踪源。
SetTraceLevel(Object, PresentationTraceLevel)	将 TraceLevel 附加属性的值设置为指定的元素。

另请参阅

• TraceSource
• System.Diagnostics
• WPF 的性能分析工具