PresentationTraceSources Class

Reference

Definition

Namespace:: System.Diagnostics

Assembly:: WindowsBase.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Provides debug tracing support that is specifically targeted for Windows Presentation Foundation (WPF) applications.

public ref class PresentationTraceSources abstract sealed

public static class PresentationTraceSources

type PresentationTraceSources = class

Public Class PresentationTraceSources

Inheritance: Object
PresentationTraceSources

Examples

The following sample configuration file enables tracing of animations, writing the output to a text file called "debug.txt". This configuration file can only be used with .NET Framework apps.

<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>

Remarks

Debug tracing is only available when a WPF application is running in full trust mode.

To enable tracing, you first must set a registry key, then you must configure trace sources.

To create the registry key, set a ManagedTracing reg_dword value to 1 under "HKeyCurrentUser\Software\Microsoft\Tracing\WPF".
To configure trace sources in a .NET Framework app, create an application config file. This file has a .config extension, for example, XamlPad.exe.config.

Achieving optimal application performance requires forethought in application design and an understanding of best practices for Windows Presentation Foundation (WPF) application development. For more information, see Optimizing WPF Application Performance.

Fields

TraceLevelProperty

Identifies the TraceLevel attached property.

Properties

AnimationSource	Gets an animation trace source.
DataBindingSource	Gets a data-binding trace source.
DependencyPropertySource	Gets a dependency property trace source.
DocumentsSource	Gets a document trace source.
FreezableSource	Gets a Freezable trace source.
HwndHostSource	Gets an hwnd host trace source.
MarkupSource	Gets a markup trace source.
NameScopeSource	Gets a name scope trace source.
ResourceDictionarySource	Gets a resource dictionary trace source.
RoutedEventSource	Gets a routed event trace source.
ShellSource	Gets a shell trace source.

Attached Properties

TraceLevel

Methods

GetTraceLevel(Object)	Gets the value of the TraceLevel attached property for a specified element.
Refresh()	Refreshes trace sources, by forcing the app.config file to be re-read.
SetTraceLevel(Object, PresentationTraceLevel)	Sets the value of the TraceLevel attached property to a specified element.

Applies to

שתף באמצעות