VSPerfCLREnvVSPerfCLREnv

L’outil VSPerfCLREnv sert à définir les variables d’environnement nécessaires pour profiler une application .NET Framework.The VSPerfCLREnv tool is used to set environment variables that are required to profile a .NET Framework application. Il utilise la syntaxe suivante :It uses the following syntax:

VsPerfCLREnv [/option]

L’option que vous choisissez dépend du type de profilage que vous utilisez : échantillonnage, instrumentation ou global.The option that you choose depends on which of the three types of profiling you use: sampling, instrumentation, or global. Vous devez utiliser une option séparée pour inclure les données d’interaction de couche dans les données de profilage.A separate option is required to include tier interaction data in the profiling data. La syntaxe de chaque option est décrite dans les tableaux suivants.The syntax for each option is described in the following tables.

Note

Quand vous avez terminé le profilage, exécutez VSPerfCLREnv avec l’option /off ou /globaloff pour supprimer les variables d’environnement nécessaires au profilage.When you are finished profiling, run VSPerfCLREnv with the /off or /globaloff option to delete the environment variables necessary for profiling. Pour plus d’informations, consultez « Options VSPerfCLREnv pour supprimer des paramètres d’environnement » ci-après.For more information, see VSPerfCLREnv Options to Delete Environment Settings shown here.

Options VSPerfCLREnv pour inclure des données d’interaction de coucheVSPerfCLREnv options for including tier-interaction data

Warning

Pour collecter des données de profilage d’interaction de couche, vous pouvez utiliser n’importe quelle édition de Visual Studio.Tier interaction profiling can be collected using any edition of Visual Studio. Cependant, ces données ne sont consultables que dans Visual Studio Enterprise.However, tier interaction profiling data can be viewed only in Visual Studio Enterprise.

Le profilage d’interaction de couche fournit des informations supplémentaires sur les requêtes ADO.NET dans des applications multicouches.Tier interaction profiling provides additional information about ADO.NET queries in multi-tiered applications. Les données sont collectées uniquement pour les appels de fonctions synchrones.Data is collected only for synchronous function calls. Vous pouvez ajouter les données d’interaction à toute exécution de profilage à l’aide de n’importe quelle méthode de profilage.Interaction data can be added to any profiling run using any profiling method.

Les options InteractionOn et GlobalInteractionOn permettent de collecter des données d’interaction de couche.The InteractionOn and GlobalInteractionOn options enable the collection of tier interaction data. Vous devez définir l’option d’interaction après la variable d’environnement VSPerfCLREnv qui est obligatoire pour profiler une application.The interaction option must be set after setting the VSPerfCLREnv environment variable that is required to profile a application.

L’exemple suivant inclut les données d’interaction de couche dans une exécution de profilage qui utilise la méthode d’échantillonnage :The following example includes tier interaction data in a profiling run that uses the sampling method:

VSPerfCLREnv /SampleOn
VSPerfCLREnv /InteractionOn
VSPerfCmd /Start:Sample /Output:MyApp.exe.vsp /Launch:MyApp.exe

L’exemple suivant inclut les données d’interaction de couche dans une exécution de profilage pour un service Windows :The following example includes tier interaction data in a profiling run for a Windows service:

VSPerfCLREnv /GlobalSampleOn
VSPerfCLREnv /GlobalInteractionOn
REM Restart the computer and start the service
VSPerfCmd /Start:Sample /Output:MyService.exe.vsp
VSPerfCmd /Attach:MyService.exe

Options VSPerfCLREnv pour le profilage par instrumentation de processusVSPerfCLREnv options for process instrumentation profiling

Le tableau suivant décrit les options VSPerfCLREnv pour le profilage par instrumentation :The following table describes VSPerfCLREnv options for instrumentation profiling:

OptionOption DescriptionDescription
TraceOnTraceOn Permet le profilage à l’aide de la méthode d’instrumentation.Enables profiling using the instrumentation method. Ne permet pas le profilage de l’allocation de mémoire ou la collecte des données de durée de vie des objets.Does not enable memory allocation profiling or collecting object lifetime data.
TraceGCTraceGC Permet le profilage de l’allocation de mémoire à l’aide de la méthode d’instrumentation.Enables memory allocation profiling using the instrumentation method. Ne permet pas la collecte des données de durée de vie des objets.Does not enable collecting object lifetime data.
TraceGCLifeTraceGCLife Permet le profilage de l’allocation de mémoire et la collecte des données de durée de vie des objets à l’aide de la méthode d’instrumentation.Enables memory allocation profiling and collecting object lifetime data using the instrumentation method.

Options VSPerfCLREnv pour le profilage par échantillonnage de processusVSPerfCLREnv options for process sampling profiling

Le tableau suivant décrit les options VSPerfCLREnv pour le profilage par échantillonnage :The following table describes VSPerfCLREnv options for sampling profiling:

OptionOption DescriptionDescription
SampleOnSampleOn Permet le profilage à l’aide de la méthode d’échantillonnage.Enables profiling using the sampling method. Ne permet pas le profilage de l’allocation de mémoire ou la collecte des données de durée de vie des objets.Does not enable memory allocation profiling or collecting object lifetime data.
SampleGCSampleGC Permet le profilage de l’allocation de mémoire à l’aide de la méthode d’échantillonnage.Enables memory allocation profiling using the sampling method. Ne permet pas la collecte des données de durée de vie des objets.Does not enable collecting object lifetime data.
SampleGCLifeSampleGCLife Permet le profilage de l’allocation de mémoire à l’aide de la méthode d’échantillonnage.Enables memory allocation profiling using the sampling method. Permet également la collecte des données de durée de vie des objets.Also enables collecting object lifetime data.
SampleLineOffSampleLineOff Désactive la collecte des données de profilage .NET au niveau ligne.Disables the collection of .NET line-level profiling data.

Options VSPerfCLREnv pour le profilage globalVSPerfCLREnv options for global profiling

Pour profiler un service managé tel qu’une application web ASP.NET qui est lancée par le système d’exploitation et non par l’utilisateur, utilisez les versions globales des options de profilage VSPerfCLREnv.To profile a managed service such as and ASP.NET web application that is started by the operating system instead of being started by the user, use options for global profiling of the VSPerfCLREnv options. Le tableau suivant décrit les versions globales des options VSPerfCLREnv.The following table describes the global versions of VSPerfCLREnv options. Ces options définissent les variables d’environnement appropriées dans le Registre.These options set the appropriate environment variables in the registry.

OptionOption DescriptionDescription
GlobalTraceOnGlobalTraceOn Permet le profilage global à l’aide de la méthode d’instrumentation.Enables global profiling using the instrumentation method. Ne collecte pas les événements d’allocation de mémoire ou les données de durée de vie des objets.Does not collect memory allocation events or object lifetime data.
GlobalTraceGCGlobalTraceGC Permet le profilage global de l’allocation de mémoire à l’aide de la méthode d’instrumentation.Enables global memory allocation profiling using the instrumentation method. Ne permet pas la collecte des données de durée de vie des objets.Does not enable collecting object lifetime data.
GlobalTraceGCLifeGlobalTraceGCLife Permet le profilage global de l’allocation de mémoire à l’aide de la méthode d’instrumentation.Enables global memory allocation profiling using the instrumentation method. Permet également la collecte des données de durée de vie des objets.Also enables the collection of object lifetime data.
GlobalSampleOnGlobalSampleOn Permet le profilage global à l’aide de la méthode d’échantillonnage.Enables global profiling using the sampling method. Ne permet pas la collecte des événements d’allocation de mémoire ou des données de durée de vie des objets.Does not enable collecting memory allocation events or object lifetime data.
GlobalSampleGCGlobalSampleGC Permet le profilage global de l’allocation de mémoire à l’aide de la méthode d’échantillonnage.Enables global memory allocation profiling using the sampling method. Ne permet pas la collecte des données de durée de vie des objets.Does not enable collecting object lifetime data.
GlobalSampleGCLifeGlobalSampleGCLife Permet le profilage global de l’allocation de mémoire à l’aide de la méthode d’échantillonnage.Enables global memory allocation profiling using the sampling method. Permet également la collecte des données de durée de vie des objets.Also enables collecting object lifetime data.

Options VSPerfCLREnv pour supprimer des paramètres d’environnementVSPerfCLREnv options to delete environment settings

Quand vous avez terminé de profiler l’application managée, utilisez une des options suivantes pour supprimer les variables d’environnement ajoutées par VSPerfCLREnv.When you are finished profiling the managed application, use one of the following options to delete the environment variables that were added by VSPerfCLREnv. Le tableau suivant explique comment supprimer les variables d’environnement des profilages global et standard :The following table describes how to delete both standard and global environment variables:

OptionOption DescriptionDescription
OffOff Supprime les variables d’environnement pour le profilage .NET standard.Deletes environment variables for standard .NET profiling. Utilisez cette option quand les options VSPerfClrEnv non globales ont été utilisées pour définir les variables d’environnement du profileur.Use this option when the non-global VSPerfClrEnv options were used to set the profiler environment variables.
GlobalOffGlobalOff Supprime les variables d’environnement pour le profilage .NET global.Deletes environment variables for global .NET profiling. Utilisez cette option quand l’application a été démarrée par le système d’exploitation et pas par le profileur.Use this option when the application was started by the operating system and not the profiler.

RemarquesRemarks

Ces options ne sont pas obligatoires pour le profilage d’une application managée si celle-ci est démarrée à l’aide de l’Explorateur de performances dans l’IDE.These options are not required for profiling a managed application if the application is started by using the Performance Explorer in the IDE. L’Explorateur de performances définit automatiquement tous les paramètres d’environnement obligatoires.The Performance Explorer sets all the required environment settings for you.

Si l’environnement approprié n’a pas été défini pendant le profilage, un avertissement est émis pendant l’analyse et les noms des fonctions managées ne sont pas correctement résolus.If the correct environment was not set during profiling, a warning is reported during analysis and the managed function names will not be properly resolved.

Voir aussiSee also

Profiler à partir de la ligne de commandeProfile from the command-line