Compartilhar via


Método DataCollection.StartProfile

O método de StartProfile define o contador como 1 (ativado) para 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 StartProfile ( _
    profileLevel As ProfileLevel, _
    elementId As UInteger _
) As ProfileOperationResult
public static ProfileOperationResult StartProfile(
    ProfileLevel profileLevel,
    uint elementId
)
public:
static ProfileOperationResult StartProfile(
    ProfileLevel profileLevel, 
    unsigned int elementId
)
static member StartProfile : 
        profileLevel:ProfileLevel * 
        elementId:uint32 -> ProfileOperationResult 
public static function StartProfile(
    profileLevel : ProfileLevel, 
    elementId : uint
) : ProfileOperationResult

Parâmetros

  • 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

StartProfile e StopProfile controlam o estado de início/fim para o nível de profiling. O valor inicial padrão iniciar/parar é 1. O valor inicial pode ser alterado no registro. Cada chamada para StartProfile define Start/Stop como 1; cada chamada para StopProfile define Start/Stop como 0.

Quando o Start/Stop for maior que 0, o estado de iniciar/parar para o nível está ativado. Quando for menor ou igual a 0, o estado de iniciar/parar é desativado.

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 estados de nível de thread para o segmento devem estar ativado.

Exemplos

O exemplo a seguir ilustra o método StartProfile.

        public void ExerciseStartProfile()
        {
            // StartProfile and StopProfile control the
            // Start/Stop state for the profiling level. 
            // The default initial value of Start/Stop is 1. 
            // The initial value can be changed in the registry. 
            // Each call to StartProfile sets Start/Stop to 1; 
            // each call to StopProfile sets it to 0. 
            
            // Declare enumeration to hold return value of 
            // the call to StartProfile.
            ProfileOperationResult profileResult;

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

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

Segurança do .NET Framework

Consulte também

Referência

DataCollection Classe

Namespace Microsoft.VisualStudio.Profiler