Partager via


DataCollection.StartProfile, méthode

La méthode StartProfile affecte au compteur la valeur 1 (activé) 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 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

Paramètres

  • 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

StartProfile et contrôle StopProfile contrôle l'état Start/Stop du niveau de profilage. La valeur initiale par défaut de Start/Stop est 1. La valeur initiale peut être modifiée dans le Registre. Chaque appel à StartProfile affecte à Start/Stop la valeur 1 ; chaque appel à StopProfile affecte la valeur 0 à Start/Stop.

Lorsque Start/Stop est supérieur à 0, l'état Start/Stop de ce niveau est ON. Lorsqu'il est inférieur ou égal à 0, l'état Start/Stop est OFF.

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 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);
        }

Sécurité .NET Framework

Voir aussi

Référence

DataCollection Classe

Microsoft.VisualStudio.Profiler, espace de noms