Exemple d’implémentation des variables localesSample implementation of locals

Important

Dans Visual Studio 2015, ce moyen d’implémenter des évaluateurs d’expression est déconseillée.In Visual Studio 2015, this way of implementing expression evaluators is deprecated. Pour plus d’informations sur l’implémentation des évaluateurs d’expression CLR, consultez évaluateurs d’expression CLR et exemple d’évaluateur d’expression managé.For information about implementing CLR expression evaluators, see CLR expression evaluators and Managed expression evaluator sample.

Voici une vue d’ensemble de la façon dont Visual Studio obtient les variables locales pour une méthode à partir de l’évaluateur d’expression (EE) :Following is an overview of how Visual Studio gets the locals for a method from the expression evaluator (EE):

  1. Visual Studio appelle le moteur de débogage (dé) GetDebugProperty pour obtenir un IDebugProperty2 objet qui représente toutes les propriétés du frame de pile, y compris les variables locales.Visual Studio calls the debug engine's (DE) GetDebugProperty to get an IDebugProperty2 object that represents all the properties of the stack frame, including the locals.

  2. IDebugStackFrame2::GetDebugProperty appels GetMethodProperty pour obtenir un objet qui décrit la méthode dans laquelle le point d’arrêt s’est produit.IDebugStackFrame2::GetDebugProperty calls GetMethodProperty to get an object that describes the method within which the breakpoint happened. Le DE fournit un fournisseur de symboles (IDebugSymbolProvider), une adresse (IDebugAddress) et un classeur (IDebugBinder).The DE supplies a symbol provider (IDebugSymbolProvider), an address (IDebugAddress), and a binder (IDebugBinder).

  3. IDebugExpressionEvaluator::GetMethodProperty appels GetContainerField avec fourni IDebugAddress objet pour lequel obtenir un IDebugContainerField qui représente la méthode contenant l’adresse spécifiée.IDebugExpressionEvaluator::GetMethodProperty calls GetContainerField with the supplied IDebugAddress object to get an IDebugContainerField that represents the method containing the specified address.

  4. Le IDebugContainerField interface est interrogée pour la IDebugMethodField interface.The IDebugContainerField interface is queried for the IDebugMethodField interface. C’est cette interface qui permet d’accéder aux variables locales de la méthode.It's this interface that gives access to the method's locals.

  5. IDebugExpressionEvaluator::GetMethodProperty instancie une classe (appelée CFieldProperty dans l’exemple) qui exécute le IDebugProperty2 interface pour représenter les variables locales de la méthode.IDebugExpressionEvaluator::GetMethodProperty instantiates a class (called CFieldProperty in the sample) that runs the IDebugProperty2 interface to represent the method's locals. Le IDebugMethodField objet est placé dans ce CFieldProperty de l’objet avec le IDebugSymbolProvider, IDebugAddress, et IDebugBinder objets.The IDebugMethodField object is placed in this CFieldProperty object along with the IDebugSymbolProvider, IDebugAddress, and IDebugBinder objects.

  6. Lorsque le CFieldProperty objet est initialisé, GetInfo est appelée sur le IDebugMethodField objet pour lequel obtenir un FIELD_INFO structure qui contient toutes les informations peut être affichées sur la méthode proprement dite.When the CFieldProperty object is initialized, GetInfo is called on the IDebugMethodField object to get a FIELD_INFO structure that contains all displayable information about the method itself.

  7. IDebugExpressionEvaluator::GetMethodProperty Retourne le CFieldProperty de l’objet comme un IDebugProperty2 objet.IDebugExpressionEvaluator::GetMethodProperty returns the CFieldProperty object as an IDebugProperty2 object.

  8. Les appels de Visual Studio EnumChildren sur retourné IDebugProperty2 objet avec le filtre guidFilterLocalsPlusArgs, qui retourne un IEnumDebugPropertyInfo2 objet contenant des variables locales de la méthode.Visual Studio calls EnumChildren on the returned IDebugProperty2 object with the filter guidFilterLocalsPlusArgs, which returns an IEnumDebugPropertyInfo2 object containing the method's locals. Cette énumération est renseignée par les appels à EnumLocals et EnumArguments.This enumeration is filled in by calls to EnumLocals and EnumArguments.

  9. Les appels de Visual Studio suivant pour obtenir un DEBUG_PROPERTY_INFO structure pour chaque local.Visual Studio calls Next to obtain a DEBUG_PROPERTY_INFO structure for each local. Cette structure contient un pointeur vers un IDebugProperty2 interface pour une variable locale.This structure contains a pointer to an IDebugProperty2 interface for a local.

  10. Les appels de Visual Studio GetPropertyInfo pour chaque locale obtenir le nom, valeur et type de l’ordinateur local.Visual Studio calls GetPropertyInfo for each local to obtain the local's name, value, and type. Ces informations s’affichent dans le variables locales fenêtre.This information is displayed in the Locals window.

Dans cette sectionIn this section

Implémentation de GetMethodPropertyImplement GetMethodProperty
Décrit une implémentation de GetMethodProperty.Describes an implementation of GetMethodProperty.

Énumérer des variables localesEnumerate locals
Décrit comment le moteur de débogage (dé) effectue un appel pour énumérer des variables locales ou les arguments.Describes how the debug engine (DE) makes a call to enumerate local variables or arguments.

Obtenir les propriétés localesGet local properties
Décrit comment le D’effectue un appel pour obtenir le nom, le type et la valeur des variables locales d’un ou plusieurs.Describes how the DE makes a call to get the name, type, and value of one or more locals.

Obtenir les valeurs localesGet local values
Décrit l’obtention de la valeur de la variable locale, ce qui nécessite les services d’un objet binder fourni par le contexte d’évaluation.Discusses getting the value of the local, which requires the services of a binder object given by the evaluation context.

Évaluer les variables localesEvaluate locals
Explique comment les variables locales sont évaluées.Explains how locals are evaluated.

Contexte d’évaluationEvaluation context
Fournit les arguments passés quand le D’appelle l’évaluateur d’expression (EE).Provides the arguments that are passed when the DE calls the expression evaluator (EE).

Exemple de MyCEEMyCEE sample
Illustre une approche d’implémentation à la création d’un évaluateur d’expression pour la langue MyC.Demonstrates one implementation approach to creating an expression evaluator for the MyC language.

Voir aussiSee also

Affichage des variables localesDisplaying locals