Metodo DataCollection.SuspendProfile

Il metodo SuspendProfile incrementa il contatore Suspend/Resume 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 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

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

SuspendProfile e ResumeProfile controllano il contatore Suspend/Resume per il livello di profilo. In genere, il contatore Suspend/Resume viene utilizzato per eseguire l'override delle funzioni standard di controllo dei dati delle API del profiler.

Il valore iniziale del contatore Suspend/Resume è 0. Ogni chiamata a SuspendProfile e a ResumeProfile rispettivamente aggiunge e sottrae 1 al conteggio Suspend/Resume.

Quando il conteggio Suspend/Resume è maggiore di 0, lo stato Suspend/Resume del livello è OFF. Quando il conteggio è minore o uguale a 0, lo stato Suspend/Resume è ON.

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 SuspendProfile. L'esempio presuppone che sia stata effettuata una chiamata precedente a StartProfile per il processo o il thread identificato dalla proprietà 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);
         }

Sicurezza di .NET Framework

Vedere anche

Riferimenti

DataCollection Classe

Spazio dei nomi Microsoft.VisualStudio.Profiler

  • Last updated on