Método DataCollection.SuspendProfile

Artigo
08/01/2011

O método SuspendProfile incrementa o contador de suspender ou retomar o nível de criação de perfil especificado.

Namespace: Microsoft.VisualStudio.Profiler
Assembly: Microsoft.VisualStudio.Profiler (em Microsoft.VisualStudio.Profiler.dll)

Sintaxe

'Declaração
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

Parâmetros

profileLevel
Tipo: Microsoft.VisualStudio.Profiler.ProfileLevel
Identifica o nível de execução do identificador especificado em elementId.

elementId
Tipo: System.UInt32
O identificador de processo ou segmento gerado pelo sistema.

Valor de retorno

Tipo: Microsoft.VisualStudio.Profiler.ProfileOperationResult
O valor de retorno, ProfileOperationResult, é um enum.

Comentários

SuspendProfile e ResumeProfile controlam o contador suspender ou retomar o nível de profiling. O contador de suspender ou retomar é normalmente usado para substituir as funções de controle de dados do profiler padrão API.

O valor inicial do contador suspender ou retomar é 0. Cada chamada para SuspendProfile adiciona 1 à contagem de suspender ou retomar; cada chamada para ResumeProfile subtrai 1.

Quando a contagem de suspender ou retomar for maior que 0, o estado de suspensão/retomada para o nível é desativado. Quando a contagem é menor ou igual a 0, o estado de suspensão/retomada está ativado.

Quando o estado de Start/Stop e o estado de suspensão/retomada estão ambos ativados, o estado de perfil para o nível está ativado. Para um segmento a ser perfilado, o processo global, e o nível de thread informa para o segmento devem estar Diante.

Exemplos

O exemplo a seguir ilustra o método SuspendProfile. Este exemplo assume que uma chamada anterior ao StartProfile foi feita para o processo ou segmento identificado pela propriedade 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);
         }

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

DataCollection Classe

Namespace Microsoft.VisualStudio.Profiler

Partilhar via