ICorDebugStepper, interface
Représente dans l'exécution du code une étape qui est effectuée par un débogueur, et qui sert d'identificateur entre l'émission et l'achèvement d'une commande tout en offrant un moyen d'annuler une étape.
Méthodes
| méthode | Description |
|---|---|
| Deactivate, méthode | Amène ce ICorDebugStepper à annuler la dernière commande de pas à pas qu’il a reçue. |
| IsActive, méthode | Obtient une valeur qui indique si cela ICorDebugStepper exécute actuellement une étape. |
| SetInterceptMask, méthode | Définit une valeur CorDebugIntercept qui spécifie les types de code qui font l’objet d’une exécution pas à pas détaillé. |
| SetRangeIL, méthode | Définit une valeur qui indique si les appels à ICorDebugStepper ::StepRange passent des valeurs d’argument par rapport au code natif ou au code CIL (Common Intermediate Language) de la méthode en cours d’exécution. |
| SetUnmappedStopMask, méthode | Définit une valeur CorDebugUnmappedStop qui spécifie le type de code non mappé dans lequel l’exécution s’arrête. |
| Step, méthode | A pour effet que cet ICorDebugStepper effectue un pas dans le thread qui le contient et, éventuellement, continue pas à pas dans les fonctions appelées à l’intérieur du thread. |
| StepOut, méthode | Provoque l’exécution de ce ICorDebugStepper à une seule étape dans son thread conteneur et à se terminer lorsque le frame actuel retourne le contrôle à l’image appelante. |
| StepRange, méthode | Provoque ce ICorDebugStepper à un seul pas dans son thread conteneur et retourne quand il atteint du code au-delà du dernier des plages spécifiées. |
Notes
L’interface ICorDebugStepper sert les objectifs suivants :
Elle agit en tant qu’identificateur entre une commande d’étape émise et l’achèvement de cette commande.
Elle fournit une interface centrale pour encapsuler toutes les exécutions pas à pas.
Elle permet d’annuler prématurément une opération pas à pas.
Un thread peut comporter plusieurs exécutions pas à pas. Par exemple, un point d’arrêt peut être atteint lors du passage d’une fonction, et l’utilisateur peut souhaiter commencer une nouvelle opération pas à pas à l’intérieur de cette fonction. Il incombe au débogueur de déterminer comment gérer cette situation. Le débogueur peut souhaiter annuler l’opération d’exécution pas à pas d’origine ou imbriquer les deux opérations. L’interface ICorDebugStepper prend en charge les deux choix.
Une exécution pas à pas peut migrer entre des threads si le Common Language Runtime (CLR) effectue un appel interthread et marshalé.
Notes
Cette interface ne prend pas en charge l'appel à distance, que ce soit entre ordinateurs ou entre processus.
Spécifications
Plateformes : Consultez Configuration requise.
En-tête : CorDebug.idl, CorDebug.h
Bibliothèque : CorGuids.lib
Versions de .NET Framework : Disponible à partir de la version 1.0
