Método DataCollection.StopProfile

Artigo
08/01/2011

O método StopProfile define o contador para 0 (desativado) 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 StopProfile ( _
    profileLevel As ProfileLevel, _
    elementId As UInteger _
) As ProfileOperationResult

public static ProfileOperationResult StopProfile(
    ProfileLevel profileLevel,
    uint elementId
)

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

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

public static function StopProfile(
    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

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 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 StopProfile. O exemplo supõe que uma chamada ao método StartProfile foi feita para o mesmo thread ou processo identificado por DataCollection.CurrentId.

        public void ExerciseStopProfile()
        {
            // 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 result of call 
            // to StopProfile.
            ProfileOperationResult profileResult;

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

            Console.WriteLine("StopProfile 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