Implémenter des visualiseurs de type et les visionneuses personnaliséesImplement type visualizers and custom viewers

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.

Visualiseurs de type et les visionneuses personnalisées permettent à un utilisateur d’afficher les données d’un type particulier d’une manière qui est plus significative qu’un vidage hexadécimal simple de nombres.Type visualizers and custom viewers let a user view data of a particular type in a way that is more meaningful than a simple hexadecimal dump of numbers. Un évaluateur d’expression (EE) pouvez associer des visionneuses personnalisées à des types de données ou des variables.An expression evaluator (EE) can associate custom viewers with specific types of data or variables. Ces visionneuses personnalisées sont implémentées par le EE.These custom viewers are implemented by the EE. Le EE peut prennent également en charge les visualiseurs de type externe, qui peuvent provenir d’un autre fournisseur tiers ou même l’utilisateur final.The EE can also support external type visualizers, which might come from another third-party vendor or even the end user.

DiscussionDiscussion

Visualiseurs de typeType visualizers

Visual Studio vous demande pour obtenir la liste de visualiseurs de type et des visionneuses personnalisées pour chaque objet à afficher dans une fenêtre Espion.Visual Studio asks for a list of type visualizers and custom viewers for every object to be displayed in a watch window. Un évaluateur d’expression (EE) fournit une telle liste pour chaque type pour lequel il souhaite prendre en charge les visualiseurs de type et les visionneuses personnalisées.An expression evaluator (EE) supplies such a list for every type for which it wants to support type visualizers and custom viewers. Les appels à GetCustomViewerCount et GetCustomViewerList démarrer l’ensemble du processus d’accéder aux visualiseurs de type et les visionneuses personnalisées (voir visualisation et affichage des donnéespour plus d’informations sur la séquence d’appel).Calls to GetCustomViewerCount and GetCustomViewerList start the whole process of accessing type visualizers and custom viewers (see Visualizing and Viewing Data for details on the calling sequence).

Visionneuses personnaliséesCustom viewers

Visionneuses personnalisées sont implémentées dans le EE pour un type de données spécifique et sont représentées par le IDebugCustomViewer interface.Custom viewers are implemented in the EE for a specific data type and are represented by the IDebugCustomViewer interface. Une visionneuse personnalisée n’est pas aussi flexible qu’un visualiseur de type, dans la mesure où il est disponible uniquement lorsque le EE qui implémente cette visionneuse personnalisée particulière est en cours d’exécution.A custom viewer is not as flexible as a type visualizer, since it is available only when the EE that implements that particular custom viewer is executing. L’implémentation d’une visionneuse personnalisée est plus simple que celle prise en charge des visualiseurs de type.Implementing a custom viewer is simpler than implementing support for type visualizers. Toutefois, prenant en charge les visualiseurs de type y offre une flexibilité maximale à l’utilisateur final pour visualiser leurs données.However, supporting type visualizers gives maximum flexibility to the end user for visualizing their data. Le reste de cet article concerne uniquement les visualiseurs de type.The remainder of this discussion concerns only type visualizers.

InterfacesInterfaces

Le EE implémente les interfaces suivantes pour prendre en charge les visualiseurs de type, pour être utilisées par Visual Studio :The EE implements the following interfaces to support type visualizers, to be consumed by Visual Studio:

Voir aussiSee also

Écriture d’un évaluateur d’expression de CLR Writing a CLR expression evaluator
Visualisation et affichage des données Visualizing and viewing data
IDebugCustomViewerIDebugCustomViewer