DataCollection.MarkProfile - метод

Статья
11/01/2012

Метод MarkProfile вставляет метку профиля в VSP-файл.Чтобы были вставлены метка и комментарий, необходимо, чтобы было включено профилирование для потока, содержащего функцию MarkProfile.

Пространство имен: 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 - пространство имен

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