DataCollection.StopProfile 方法

StopProfile 方法将指定分析级别的计数器设置为 0(关闭)。

命名空间:  Microsoft.VisualStudio.Profiler
程序集:  Microsoft.VisualStudio.Profiler(在 Microsoft.VisualStudio.Profiler.dll 中)

语法

声明
Public Shared Function StopProfile ( _
    profileLevel As ProfileLevel, _
    elementId As UInteger _
) As ProfileOperationResult
public static ProfileOperationResult StopProfile(
    ProfileLevel profileLevel,
    uint elementId
)
public:
static ProfileOperationResult StopProfile(
    ProfileLevel profileLevel, 
    unsigned int elementId
)
static member StopProfile : 
        profileLevel:ProfileLevel * 
        elementId:uint32 -> ProfileOperationResult 
public static function StopProfile(
    profileLevel : ProfileLevel, 
    elementId : uint
) : ProfileOperationResult

参数

  • elementId
    类型:System.UInt32
    系统生成的进程或线程标识符。

返回值

类型:Microsoft.VisualStudio.Profiler.ProfileOperationResult
返回值 ProfileOperationResult 是一个枚举。

备注

StartProfile 和 StopProfile 控制分析级别的开始/停止状态。 开始/停止的默认初始值为 1。 可在注册表中更改的初始值。 每次调用 StartProfile 会将开始/停止设置为 1;每次调用 StopProfile 会将其设置为 0。

当开始/停止大于 0 时,该级别的开始/停止状态为 ON。 当它小于或等于 0 时,开始/停止状态为 OFF。

当开始/停止状态和挂起/继续状态都为 ON 时,该级别的分析状态为 ON。 对于要分析的线程,该线程的全局状态、进程状态和线程级别状态必须为 ON。

示例

下面的示例演示 StopProfile 方法。 该示例假定已对由 DataCollection.CurrentId 标识的同一线程或进程调用了 StartProfile 方法。

        public void ExerciseStopProfile()
        {
            // 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 result of call 
            // to StopProfile.
            ProfileOperationResult profileResult;

            profileResult = DataCollection.StopProfile(
                ProfileLevel.Global,
                DataCollection.CurrentId);

            Console.WriteLine("StopProfile returned {0}", profileResult);
        }

.NET Framework 安全性

请参见

参考

DataCollection 类

Microsoft.VisualStudio.Profiler 命名空间