DataCollection.NameProfile - метод

Статья
11/01/2012

Метод 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 создает ошибку.Функции API CreateProcess() и CreateThread() могут вернуть значение до инициирования потока или процесса.

Примеры

В следующем примере иллюстрируется использование метода 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

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

DataCollection Класс

Microsoft.VisualStudio.Profiler - пространство имен

Поделиться через