DataCollection.StartProfile 方法
StartProfile 方法将指定分析级别的计数器设置为 1(开启)。
命名空间: Microsoft.VisualStudio.Profiler
程序集: Microsoft.VisualStudio.Profiler(在 Microsoft.VisualStudio.Profiler.dll 中)
语法
声明
Public Shared Function StartProfile ( _
profileLevel As ProfileLevel, _
elementId As UInteger _
) As ProfileOperationResult
public static ProfileOperationResult StartProfile(
ProfileLevel profileLevel,
uint elementId
)
public:
static ProfileOperationResult StartProfile(
ProfileLevel profileLevel,
unsigned int elementId
)
static member StartProfile :
profileLevel:ProfileLevel *
elementId:uint32 -> ProfileOperationResult
public static function StartProfile(
profileLevel : ProfileLevel,
elementId : uint
) : ProfileOperationResult
参数
- profileLevel
类型:Microsoft.VisualStudio.Profiler.ProfileLevel
标识在 elementId 中指定的标识符的执行级别。
- elementId
类型:System.UInt32
系统生成的进程或线程标识符。
返回值
类型:Microsoft.VisualStudio.Profiler.ProfileOperationResult
返回值 ProfileOperationResult 是一个枚举。
备注
StartProfile 和 StopProfile 控制分析级别的开始/停止状态。 开始/停止的默认初始值为 1。 可在注册表中更改的初始值。 每次调用 StartProfile 会将开始/停止设置为 1;每次调用 StopProfile 会将启动/停止设置为 0。
当开始/停止大于 0 时,该级别的开始/停止状态为 ON。 当它小于或等于 0 时,开始/停止状态为 OFF。
当开始/停止状态和挂起/继续状态都为 ON 时,该级别的分析状态为 ON。 对于要分析的线程,该线程的全局状态、进程状态和线程级别状态必须为 ON。
示例
下面的示例演示 StartProfile 方法。
public void ExerciseStartProfile()
{
// StartProfile and StopProfile control the
// Start/Stop state for the profiling level.
// The default initial value of Start/Stop is 1.
// The initial value can be changed in the registry.
// Each call to StartProfile sets Start/Stop to 1;
// each call to StopProfile sets it to 0.
// Declare enumeration to hold return value of
// the call to StartProfile.
ProfileOperationResult profileResult;
profileResult = DataCollection.StartProfile(
ProfileLevel.Global,
DataCollection.CurrentId);
Console.WriteLine("StartProfile returned {0}", profileResult);
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。