DataCollection.NameProfile 方法
NameProfile 方法会将字符串分配给指定的进程或线程。
命名空间： Microsoft.VisualStudio.Profiler
程序集： Microsoft.VisualStudio.Profiler（在 Microsoft.VisualStudio.Profiler.dll 中）
语法
声明
Public Shared Function NameProfile ( _
profileName As String, _
profileLevel As ProfileLevel, _
elementId As UInteger _
) As NameOperationResult
public static NameOperationResult NameProfile(
string profileName,
ProfileLevel profileLevel,
uint elementId
)
public:
static NameOperationResult NameProfile(
String^ profileName,
ProfileLevel profileLevel,
unsigned int elementId
)
static member NameProfile :
profileName:string *
profileLevel:ProfileLevel *
elementId:uint32 -> NameOperationResult
public static function NameProfile(
profileName : String,
profileLevel : ProfileLevel,
elementId : uint
) : NameOperationResult
参数
- profileName
类型：System.String
分析元素的名称。
- profileLevel
类型：Microsoft.VisualStudio.Profiler.ProfileLevel
标识在 elementId 中指定的标识符的执行级别。
- elementId
类型：System.UInt32
分析级别标识符。使用系统生成的进程或线程标识符。
返回值
类型：Microsoft.VisualStudio.Profiler.NameOperationResult
返回值 NameOperationResult 是一个枚举。
备注
只能为每个进程或线程分配一个名称。 命名分析元素后，会忽略对该元素的 NameProfile 的后续调用。
如果为不同线程或进程指定了相同名称，则报告中将包含来自该级别中所有具有该名称的元素的数据。
如果指定当前进程或线程以外的进程或线程，则必须确保在命名之前该进程或线程已初始化且已开始运行。 否则，NameProfile 方法会失败。 初始化线程或进程之前，CreateProcess() 和 CreateThread() API 函数都可返回。
示例
下面的示例演示 NameProfile 方法。
public void ExerciseNameProfile()
{
// Create and initalize variables to pass to
// ExerciseNameProfile. The values of this
// parameter is based on the needs of the code;
// and for the sake of simplicity in this example,
// the variable is assigned
// an arbitrary value.
string profileName = "ExerciseNameProfile";
// Declare enumeration to hold result of call to
// ExerciseNameProfle.
NameOperationResult nameResult;
nameResult = DataCollection.NameProfile(
profileName,
ProfileLevel.Global,
DataCollection.CurrentId);
Console.WriteLine("NameProfile returned {0}", nameResult);
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。