DataCollection.SuspendProfile - метод

Статья
11/01/2012

Метод SuspendProfile увеличивает на единицу значение счетчика Пауза/Возобновление для указанного уровня профилирования.

Пространство имен: Microsoft.VisualStudio.Profiler
Сборка: Microsoft.VisualStudio.Profiler (в Microsoft.VisualStudio.Profiler.dll)

Синтаксис

'Декларация
Public Shared Function SuspendProfile ( _
    profileLevel As ProfileLevel, _
    elementId As UInteger _
) As ProfileOperationResult

public static ProfileOperationResult SuspendProfile(
    ProfileLevel profileLevel,
    uint elementId
)

public:
static ProfileOperationResult SuspendProfile(
    ProfileLevel profileLevel, 
    unsigned int elementId
)

static member SuspendProfile : 
        profileLevel:ProfileLevel * 
        elementId:uint32 -> ProfileOperationResult

public static function SuspendProfile(
    profileLevel : ProfileLevel, 
    elementId : uint
) : ProfileOperationResult

Параметры

profileLevel
Тип: Microsoft.VisualStudio.Profiler.ProfileLevel
Идентифицирует уровень выполнения идентификатора, заданного в elementId.

elementId
Тип: System.UInt32
Идентификатор процесса или потока, созданный системой.

Возвращаемое значение

Тип: Microsoft.VisualStudio.Profiler.ProfileOperationResult
Возвращаемое значение ProfileOperationResult является перечислением.

Заметки

Методы SuspendProfile и ResumeProfile управляют значением счетчика Пауза/Возобновление для уровня профилирования.Счетчик Пауза/Возобновление обычно используется для переопределения стандартных функций управления данными средства профилирования API.

Начальное значение счетчика приостановки/возобновления равно 0.Каждый вызов SuspendProfile добавляет 1 к счетчику приостановки/возобновления; каждый вызов ResumeProfile вычитает 1.

Если значение счетчика Пауза/Возобновление больше 0, состояние Пауза/Возобновление для уровня выключено.Если значение счетчика больше или равно 0, состояние Пауза/Возобновление включено.

Если Пуск/Остановка, и Пауза/Возобновление включены, состояние профилирования для данного уровня включено.</para>Для профилируемого потока состояния глобального уровня, уровня процесса и потока должны быть равны значению ON.

Примеры

В следующем примере демонстрируется использование метода SuspendProfile.В примере предполагается, что предыдущий вызов метода StartProfile выполнен для потока или процесса, который идентифицирует DataCollection.CurrentId свойства.

        public void ExerciseSuspendProfile()
        {
            // The initial value of the Suspend/Resume counter is 0.
            // Each call to SuspendProfile adds 1 to the 
            // Suspend/Resume count; each call 
            // to ResumeProfile subtracts 1. 
                        
            // Declare enumeration to hold result of call 
            // to SuspendProfile
            ProfileOperationResult profileResult;

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

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

Безопасность платформы .NET Framework

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

См. также

Ссылки

DataCollection Класс

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

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