DataCollection.SuspendProfile 方法
SuspendProfile 方法递增指定分析级别的挂起/继续计数器的值。
命名空间： Microsoft.VisualStudio.Profiler
程序集： Microsoft.VisualStudio.Profiler（在 Microsoft.VisualStudio.Profiler.dll 中）
语法
声明
Public Shared Function SuspendProfile ( _
profileLevel As ProfileLevel, _
elementId As UInteger _
) As ProfileOperationResult
public static ProfileOperationResult SuspendProfile(
ProfileLevel profileLevel,
uint elementId
)
public:
static ProfileOperationResult SuspendProfile(
ProfileLevel profileLevel,
unsigned int elementId
)
static member SuspendProfile :
profileLevel:ProfileLevel *
elementId:uint32 -> ProfileOperationResult
public static function SuspendProfile(
profileLevel : ProfileLevel,
elementId : uint
) : ProfileOperationResult
参数
- profileLevel
类型：Microsoft.VisualStudio.Profiler.ProfileLevel
标识在 elementId 中指定的标识符的执行级别。
- elementId
类型：System.UInt32
系统生成的进程或线程标识符。
返回值
类型：Microsoft.VisualStudio.Profiler.ProfileOperationResult
返回值 ProfileOperationResult 是一个枚举。
备注
SuspendProfile 和 ResumeProfile 控制分析级别的挂起/继续计数器。 挂起/继续计数器通常用于重写标准的探查器 API 数据控制函数。
Suspend/Resume 计数器的初始值是 0。 每次调用 SuspendProfile 都会将挂起/继续计数加一；每次调用 ResumeProfile 则会将其减一。
当挂起/继续计数大于 0 时，该级别的挂起/继续状态为 OFF。 当该计数小于或等于 0 时，挂起/继续状态为 ON。
当开始/停止状态和挂起/继续状态都为 ON 时，该级别的分析状态为 ON。 对于要分析的线程，该线程的全局状态、进程状态和线程级别状态都必须为 ON。
示例
下面的示例演示 SuspendProfile 方法。 该示例假定此前已对由属性 DataCollection.CurrentId 标识的进程或线程调用了 StartProfile。
public void ExerciseSuspendProfile()
{
// The initial value of the Suspend/Resume counter is 0.
// Each call to SuspendProfile adds 1 to the
// Suspend/Resume count; each call
// to ResumeProfile subtracts 1.
// Declare enumeration to hold result of call
// to SuspendProfile
ProfileOperationResult profileResult;
profileResult = DataCollection.SuspendProfile(
ProfileLevel.Global,
DataCollection.CurrentId);
Console.WriteLine("SuspendProfile returned {0}", profileResult);
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。