Start CPU profiling.

Namespace:  YourKit.Profiler.Api
Assembly:  YourKit.Profiler.Api (in YourKit.Profiler.Api.dll) Version: 4.5.6.556 (4.5.6.556)

Syntax

C#
public void StartCPUProfiling(
	long mode,
	string filters,
	string wallTimeSpec
)
Visual Basic (Declaration)
Public Sub StartCPUProfiling ( _
	mode As Long, _
	filters As String, _
	wallTimeSpec As String _
)
Visual C++
public:
void StartCPUProfiling(
	long long mode, 
	String^ filters, 
	String^ wallTimeSpec
)

Parameters

mode
Type: System..::.Int64
CPU_SAMPLING or CPU_TRACING
filters
Type: System..::.String
String containing '\n'-separated list of classes whose methods should not be profiled. Alternatively, you may want to profile only particular methods; in this case, add '+' at the beginning of filters. Wildcards are accepted in identifier names ('*'). More methods are profiled, bigger the overhead.
The filters are used with CPU_TRACING only; with CPU_SAMPLING the value is ignored. If null or empty string passed, all methods will be profiled (not recommended due to high overhead).

Use DEFAULT_FILTERS unless you want to specify your custom settings.

Find detail on filters at http://www.yourkit.com/docs/net45/help/filters.jsp.
wallTimeSpec
Type: System..::.String
For which methods should wall time be measured instead of CPU time.

Use DEFAULT_WALLTIME_SPEC unless you want to specify your custom settings.

Please read more about time measurement at http://www.yourkit.com/docs/net45/help/times.jsp.

Exceptions

ExceptionCondition
System..::.Exception If CPU profiling cannot be started. Possible reasons:
  • CPU profiling is already running
  • CPU tracing is not enabled in the profiled application (on attempt to start CPU tracing)
  • profiled application has terminated
  • I/O failure

See Also