Comment : limiter l’instrumentation à des fonctions spécifiquesHow to: Limit Instrumentation to Specific Functions

Vous pouvez limiter l’instrumentation et la collecte de données à une ou plusieurs fonctions en configurant des options dans la page Avancé de la Session de performance ou dans les pages de propriétés des fichiers binaires cibles :You can limit instrumentation and data collection to one or more functions by setting options in the Advanced page of the Performance Session or target binary property pages:

  • Si vous spécifiez des fonctions dans la page de propriétés de la session de performance, seules ces fonctions seront instrumentées dans tous les fichiers binaires instrumentés de la session.If you specify the functions on the performance session property page, only those functions are instrumented in all instrumented binaries of the session.

  • Si vous spécifiez des fonctions dans la page de propriétés d’un fichier binaire cible, seules les fonctions qui figurent dans ce fichier binaire seront instrumentées.If you specify the functions on the property page of a target binary, only those functions that are in that particular binary are instrumented. Les fonctions des autres fichiers binaires de la session performance sont instrumentées normalement.Functions in other binaries of the performance are instrumented as usual.

    Le fait de limiter ainsi la collecte de données est possible uniquement lorsque la méthode de profilage par instrumentation est sélectionnée.Limiting data collection in this manner is supported only when the instrumentation profiling method is selected.

Note

Vous pouvez également utiliser la page Avancé des pages de propriétés Session de performance pour définir d’autres options qui sont disponibles dans l’outil d’instrumentation en ligne de commande VSInstr des outils de profilage.You can also use the Advanced page of the Performance Session property pages to set other options that are available to the Profiling Tools VSInstr command line instrumentation tool.

Pour limiter l’instrumentation à certaines fonctions dans une session de performanceTo limit instrumentation to specific functions in a performance session

  1. Dans l’Explorateur de performances, cliquez avec le bouton droit sur le nom de la session, puis cliquez sur Propriétés.In Performance Explorer, right-click the session name and then click Properties.

    La boîte de dialogue Pages de propriétés s’affiche.The Property Pages dialog box is displayed.

  2. Dans la boîte de dialogue Pages de propriétés, cliquez sur Avancé.On the Property Pages dialog box, click Advanced.

  3. Dans la zone de texte Options d’instrumentation supplémentaires, utilisez la syntaxe suivante pour taper le nom des fonctions que vous voulez instrumenter :In the Additional instrumentation options text box, use the following syntax to type the name of the functions that you want to instrument:

    /include: FuncSpec [; FuncSpec ] .../include: FuncSpec [; FuncSpec ] ...

    FuncSpec correspond au nom de l’espace de noms et de la fonction.FuncSpec is the namespace and function name. Son format est le suivant : Namespace::FunctionName.It has the format Namespace::FunctionName. Utilisez un point-virgule pour séparer les fonctions.Use a semicolon to separate multiple functions. Utilisez un astérisque (*) pour spécifier un caractère générique pour un ou plusieurs caractères.Use an asterisk (*) to specify a wildcard for one or more characters. Par exemple, /include:MyNS::\* spécifie toutes les fonctions de l’espace de noms MyNS.For example, /include:MyNS::\* specifies all functions in the MyNS namespace.

    Note

    Pour répertorier les fonctions d’un fichier binaire, ouvrez une fenêtre d’invite de commandes dans le répertoire d’installation des outils de profilage (il s’agit en général du répertoire \Team Tools\Performance Tools sous le répertoire d’installation de Visual Studio Application Lifecycle ManagementVisual Studio Application Lifecycle Management), puis tapez vsinstr /DumpFuncs.To list the functions in a binary, open a command prompt window in the Profiling Tools installation directory (typically, the \Team Tools\Performance Tools directory under the Visual Studio Application Lifecycle ManagementVisual Studio Application Lifecycle Management installation directory) and then type vsinstr /DumpFuncs

Pour limiter l’instrumentation à certaines fonctions d’un fichier binaireTo limit instrumentation to specific functions in a binary

  1. Dans l’Explorateur de performances, recherchez le nom du fichier binaire sous le nœud Cibles de la session de performance.In Performance Explorer, locate the binary name in the Targets node of the performance session.

  2. Cliquez avec le bouton droit sur le nom du fichier binaire, puis cliquez sur Propriétés.Right-click the binary name and then click Properties.

    La boîte de dialogue Pages de propriétés s’affiche.The Property Pages dialog box is displayed.

  3. Dans la boîte de dialogue Pages de propriétés, cliquez sur Avancé.On the Property Pages dialog box, click Advanced.

  4. Dans la zone de texte Options d’instrumentation supplémentaires, utilisez la syntaxe suivante pour taper le nom des fonctions que vous voulez instrumenter :In the Additional instrumentation options text box, use the following syntax to type the name of the functions that you want to instrument:

    /include: FuncSpec [; FuncSpec ] .../include: FuncSpec [; FuncSpec ] ...

    FuncSpec correspond au nom de l’espace de noms et de la fonction.FuncSpec is the namespace and function name. Son format est le suivant : Namespace::FunctionName.It has the format Namespace::FunctionName. Utilisez un point-virgule pour séparer les fonctions.Use a semicolon to separate multiple functions. Utilisez un astérisque (*) pour spécifier un caractère générique pour un ou plusieurs caractères.Use an asterisk (*) to specify a wildcard for one or more characters. Par exemple, /include:MyNS::\* spécifie toutes les fonctions de l’espace de noms MyNS.For example, /include:MyNS::\* specifies all functions in the MyNS namespace.

    Note

    Pour répertorier les fonctions d’un fichier binaire, ouvrez une fenêtre d’invite de commandes dans le répertoire d’installation des outils de profilage (il s’agit en général du répertoire \Team Tools\Performance Tools sous le répertoire d’installation de Visual Studio Application Lifecycle ManagementVisual Studio Application Lifecycle Management), puis tapez vsinstr /DumpFuncs.To list the functions in a binary, open a command prompt window in the Profiling Tools installation directory (typically, the \Team Tools\Performance Tools directory under the Visual Studio Application Lifecycle ManagementVisual Studio Application Lifecycle Management installation directory) and then type vsinstr /DumpFuncs

Voir aussiSee Also

Contrôle de la collecte de données Controlling Data Collection
Guide pratique pour limiter l’instrumentation à des DLL spécifiques How to: Limit Instrumentation to Specific DLLs
Guide pratique pour spécifier des options d’instrumentation supplémentairesHow to: Specify Additional Instrumentation Options