DataCollection.MarkProfile 方法

MarkProfile 方法在 .vsp 文件中插入分析标记。 对包含 MarkProfile 函数的线程进行的分析必须为 ON,才能插入标记。

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

语法

声明
Public Shared Function MarkProfile ( _
    markId As Integer _
) As MarkOperationResult
public static MarkOperationResult MarkProfile(
    int markId
)
public:
static MarkOperationResult MarkProfile(
    int markId
)
static member MarkProfile : 
        markId:int -> MarkOperationResult 
public static function MarkProfile(
    markId : int
) : MarkOperationResult

参数

  • markId
    类型:System.Int32
    要插入的标记。该标记必须大于或等于 0(零)。

返回值

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

备注

如果正在分析包含 MarkProfile 函数的线程,则每次代码运行时都会在 .vsp 文件中插入标记值。 您可以多次调用 MarkProfile。

分析标记具有全局范围。 例如,插入到一个线程中的分析标记可用于标记 .vsp 文件中任何线程的数据段的开始或结束。

当通过 Mark 命令或 API 函数(CommentMarkAtProfile、CommentMarkProfile 或 MarkProfile)插入标记和注释时,包含标记分析函数的线程的分析状态必须为开启。

重要

MarkProfile 方法应仅用于检测。

示例

下面的示例演示 MarkProfile 方法。

        public void ExerciseMarkProfile()
        {
            // Declare and initialize variables to pass to 
            // MarkProfile.  The values of these parameters 
            // are assigned based on the needs of the code;
            // and for the sake of simplicity in this example, 
            // the variables are assigned arbitrary values.
            int markId = 03;

            // Declare enumeration to hold return value of 
            // call to MarkProfile.
            MarkOperationResult markResult;

            markResult = DataCollection.MarkProfile(
                markId);

            Console.WriteLine("MarkProfile returned {0}", markResult);
        }

.NET Framework 安全性

请参见

参考

DataCollection 类

Microsoft.VisualStudio.Profiler 命名空间