Metodo DataCollection.StopProfile

Il metodo StopProfile imposta il contatore su 0 (off) per il livello di profilatura specificato.

Spazio dei nomi:  Microsoft.VisualStudio.Profiler
Assembly:  Microsoft.VisualStudio.Profiler (in Microsoft.VisualStudio.Profiler.dll)

Sintassi

'Dichiarazione
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

Parametri

  • elementId
    Tipo: System.UInt32
    Identificatore del processo o del thread generato dal sistema.

Valore restituito

Tipo: Microsoft.VisualStudio.Profiler.ProfileOperationResult
Il valore restituito ProfileOperationResult è un'enumerazione.

Note

StartProfile e StopProfile controllano lo stato Start/Stop per il livello di profilo. Il valore iniziale di Start/Stop è 1. Il valore iniziale può essere modificato nel Registro di sistema. Ogni chiamata a StartProfile e a StopProfile imposta Start/Stop rispettivamente su 1 e su 0.

Quando il valore di Start/Stop è maggiore di 0, lo stato Start/Stop del livello è ON. Quando il valore del contatore è minore o uguale a 0, lo stato Start/Stop è OFF.

Quando gli stati Start/Stop e Suspend/Resume sono entrambi impostati su ON, lo stato di profilo del livello è ON. Per il profilo di un thread, è necessario che gli stati a livello globale, di processo e di thread siano tutti impostati su ON.

Esempi

Nell'esempio riportato di seguito viene illustrato il metodo StopProfile. L'esempio presuppone che sia stata effettuata una chiamata al metodo StartProfile per lo stesso thread o processo identificato dalla proprietà 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);
        }

Sicurezza di .NET Framework

Vedere anche

Riferimenti

DataCollection Classe

Spazio dei nomi Microsoft.VisualStudio.Profiler