Comment : rechercher des objets, des définitions et des références (symboles)

Article
08/21/2008

Mise à jour : novembre 2007

Dans l'Explorateur d'objets, vous pouvez filtrer les noms des symboles affichés dans le volet Objets de la portée d'exploration en cours en sélectionnant ou en tapant une chaîne de recherche dans la liste <Recherche> de la barre d'outils Explorateur d'objets. Cliquez sur Rechercher pour afficher tous les noms de symboles dans la portée d'exploration en cours qui incluent la chaîne de recherche. Ainsi, la recherche de la chaîne « MyObject » retourne les expressions « MyObject », « MyObjectTest » et « CMyObject ». Les recherches ne respectent pas la casse.

Vous pouvez également rechercher des symboles à l'aide de l'onglet Rechercher un symbole de la fenêtre Rechercher ou remplacer, ou de la commande Rechercher toutes les références des menus contextuels de l'Explorateur d'objets. Ces recherches affichent leurs résultats dans la fenêtre Résultats de la recherche de symbole. Pour obtenir des informations sur ces fenêtres, consultez Rechercher un symbole, fenêtre Rechercher et remplacer, et la fenêtre Fenêtre Résultats de la recherche de symbole. Vous pouvez également rechercher des définitions en cliquant sur la commande Atteindre la définition du menu contextuel de l'éditeur de code.

Recherche de symboles à l'aide d'une chaîne de recherche

Le menu Rechercher de la barre d'outils Explorateur d'objets utilise la portée d'exploration en cours sélectionnée dans le menu Parcourir. Pour plus d'informations sur la portée des recherches, consultez Comment : afficher et modifier la portée de l'exploration.

Pour explorer la portée d'exploration en cours à l'aide d'une chaîne de recherche

Dans le champ Chaîne de recherche de la barre d'outils Explorateur d'objets, sélectionnez une chaîne de recherche précédente ou entrez tout ou partie d'un nom de symbole.
Cliquez sur Rechercher.

Le volet Objets affiche uniquement les éléments de la portée d'exploration du menu Parcourir dont les noms incluent la Chaîne de recherche. La chaîne est mise en surbrillance dans chaque nom de symbole où elle apparaît.

Pour effacer les résultats

Cliquez sur le bouton Effacer la recherche de la barre d'outils Explorateur d'objets.

Le volet Objets affiche maintenant tous les objets de la portée d'exploration en cours.

Recherche de symboles à l'aide de Rechercher un symbole

Utilisez l'onglet Rechercher un symbole de la fenêtre Rechercher et remplacer, ou la commande Rechercher toutes les références des menus contextuels Explorateur d'objets, pour rechercher les lignes de votre code de projet où un symbole est défini, référencé ou utilisé.

Rechercher un symbole permet de :

Rechercher la définition d'un symbole dans votre projet, ou découvrir plusieurs définitions d'un symbole.
Rechercher des références à un symbole, et des instances où il est utilisé dans votre code.
Explorer les hiérarchies d'objets dans les composants référencés et externes, et, ainsi, en apprendre plus sur leurs fonctionnalités.

La fonction Rechercher un symbole est différente de la recherche de texte pour les raisons suivantes :

Vous permet de limiter la zone de la recherche aux symboles uniquement.
Indique les définitions et les références au symbole (le cas échéant) dans la Fenêtre Résultats de la recherche de symbole.
Il est possible d'effectuer une recherche dans les composants externes pour lesquels vous ne disposez pas du code source.

Pour afficher l'onglet Rechercher un symbole

Dans le menu Edition, choisissez Rechercher et remplacer.
Choisissez Rechercher un symbole.

- ou -
Si la fenêtre Rechercher et remplacer est déjà ouverte, sur la barre d'outils, cliquez sur le bouton triangulaire Afficher de la liste déroulante gauche, puis choisissez Rechercher un symbole.

Pour rechercher des noms de symboles qui correspondent à une chaîne de recherche

Extrayez tous fichiers à explorer et stockés sous contrôle de code source.
Basculez tous les documents ouverts dans les éditeurs en mode Design vers le mode Source.
Sélectionnez Rechercher et remplacer dans le menu Edition, puis choisissez Rechercher un symbole.

La fenêtre Rechercher et remplacer s'ouvre avec les options Rechercher un symbole affichées.
Dans la liste déroulante Regarder dans, sélectionnez une zone de recherche.
- Tous les composants - Recherche tous les composants disponibles pour la chaîne Rechercher, y compris la solution en cours et ses composants référencés, la totalité du .NET Framework et tous les composants que vous avez ajoutés à l'aide d'Ajouter d'autres composants.
- .NET Framework - Explore la totalité de la bibliothèque de classes du .NET Framework.
- Ma solution - Recherche les noms de symboles déjà définis ou référencés dans la solution ouverte.
- ou -

Sélectionnez l'une des zones de recherche Jeu de composants personnalisés.
- Jeu de composants personnalisés (Explorateur d'objets) - Recherche les composants ajoutés actuellement à la zone de recherche Jeu de composants personnalisés de l'Explorateur d'objets.
- Jeu de composants personnalisés (Rechercher un symbole) - Recherche les composants ajoutés actuellement à la zone de recherche Jeu de composants personnalisés Rechercher un symbole.
- ou -

Cliquez sur le bouton Parcourir (...) pour afficher la Modifier un jeu de composants personnalisés, boîte de dialogue et sélectionnez un jeu personnalisé de dossiers de recherche. Pour plus d'informations, consultez Comment : afficher et modifier la portée de l'exploration.

Définissez Options de recherche selon vos besoins. Vous pouvez choisir de rechercher :

Mot entier - Lorsque vous sélectionnez cette option, la fenêtre Résultats de la recherche de symbole n'affiche que les instances de la chaîne Rechercher contenant les mêmes mots entiers. Par exemple, la recherche de « MyObject » retourne « MyObject », mais pas « CMyObject » ni « MyObjectC ».
Préfixe - Lorsque cette option est sélectionnée, la fenêtre Résultats de la recherche de symbole affiche les symboles dont les noms commencent par la chaîne Rechercher. Par exemple, une recherche de "MyObject" retourne "MyObject", "MyObjectTest", etc., mais pas "CMyObject".
Sous-chaîne - Lorsque cette option est sélectionnée, la fenêtre Résultats de la recherche de symbole affiche tous les symboles dont les noms incluent la chaîne Rechercher à un emplacement quelconque. Par exemple, une recherche qui utilise "MyObject" retourne "MyObject", "MyObjectTest" et "CMyObject".

Pour chacune de ces options, vous pouvez choisir :

Respecter la casse - Lorsque vous sélectionnez cette option, la fenêtre Résultats de la recherche de symbole affiche seulement les instances de la chaîne Rechercher dont le contenu et la casse sont identiques. Par exemple, la recherche de « MyObject » avec l'option Respecter la casse sélectionnée retourne « MyObject », mais pas « myobject » ni « MYOBJECT ».

Remarque :
Comme les options Rechercher et remplacer sont globales, elles demeurent effectives d'une recherche à l'autre. Pour plus d'informations, consultez Rechercher un symbole, fenêtre Rechercher et remplacer.

Dans la zone de texte Rechercher, entrez la chaîne ou l'expression à rechercher. Remarque Les caractères génériques et les expressions régulières ne peuvent pas être utilisés dans les recherches Rechercher un symbole.
Cliquez sur Rechercher tout pour commencer la recherche. Pour annuler une recherche en cours, cliquez sur Arrêter.

Les correspondances trouvées sont répertoriées dans la Fenêtre Résultats de la recherche de symbole. Pour accéder à une correspondance de recherche, double-cliquez sur son entrée.

La commande Atteindre la définition du menu contextuel de l'éditeur de code vous permet d'accéder directement à la définition d'origine de l'élément de code sélectionné. Vous pouvez également appuyer sur la touche F12 pour appeler la commande Atteindre la définition.

La commande Atteindre la définition fonctionne avec les éléments de code tels que les membres, les types, les variables, les variables locales, etc. Elle utilise les informations sur le compilateur pour vous faire directement accéder à l'emplacement où l'élément de code a été initialement défini, même si votre code utilise de nombreuses surcharges ou inférences de type. Toutefois, Visual Studio doit pouvoir accéder au code où l'élément est défini pour que la commande Atteindre la définition fonctionne correctement.

Pour naviguer jusqu'à une définition

Cliquez avec le bouton droit sur un élément de code dans l'éditeur de code, puis cliquez sur Atteindre la définition.

Le module où le code a été initialement défini, s'il est disponible, s'affiche dans un nouvel onglet de l'éditeur de code. Si la définition n'est pas disponible, un message d'erreur vous indique que la navigation vers la définition est impossible.