DataCollection.SuspendProfile, méthode

Article
08/10/2011

La méthode SuspendProfile incrémente le compteur de Suspend/Resume 'Interrompez/en sens inverse pour le niveau de profilage spécifié.

Espace de noms : Microsoft.VisualStudio.Profiler
Assembly : Microsoft.VisualStudio.Profiler (dans Microsoft.VisualStudio.Profiler.dll)

Syntaxe

'Déclaration
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

Paramètres

profileLevel
Type : Microsoft.VisualStudio.Profiler.ProfileLevel
Identifie le niveau d'exécution de l'identificateur spécifié dans elementId.

elementId
Type : System.UInt32
Identificateur de processus ou de thread généré par le système.

Valeur de retour

Type : Microsoft.VisualStudio.Profiler.ProfileOperationResult
La valeur de retour, ProfileOperationResult, est un enum.

Notes

SuspendProfile et contrôle ResumeProfile contrôlent le compteur de Suspend/Resume pour le niveau de profilage. Le compteur de Suspend/Resume permet généralement de substituer les fonctions de contrôle des données API du profileur standard.

La valeur initiale du compteur Suspend/Resume est 0. Chaque appel à SuspendProfile ajoute 1 au nombre de Suspend/Resume ; chaque appel à ResumeProfile enlève 1.

Lorsque le nombre de Suspend/Resume est supérieur ou égal à 0, l'état Suspend/Resume du niveau est OFF. Lorsque le nombre est inférieur ou égal à 0, l'état de Suspend/Resume est ON.

Lorsque l'état Start/Stop et l'état Suspend/Resume sont tous deux ON, l'état de profilage du niveau est ON. Pour qu'un thread soit profilé, les états au niveau global, du processus et du thread doivent être ON.

Exemples

L'exemple suivant illustre la méthode SuspendProfile. Cet exemple suppose qu'un appel antérieur à StartProfile a été effectué pour le processus ou le thread identifié par la propriété 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);
         }

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

DataCollection Classe

Microsoft.VisualStudio.Profiler, espace de noms

Partager via