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

Vous pouvez utiliser l'Explorateur d'objets ou les fonctionnalités Naviguer vers, Rechercher un symbole et Atteindre la définition pour rechercher des objets, des définitions ou des références (symboles) dans une solution.

Dans l'Explorateur d'objets, vous avez la possibilité de taper une chaîne de recherche afin de filtrer les noms des symboles affichés dans le volet Objets pour la portée d'exploration actuelle. Par exemple, la chaîne MyObject retourne « MyObject », « MyObjectTest » et « CMyObject ».

Vous pouvez utiliser la fonctionnalité Naviguer vers pour rechercher un symbole ou un fichier dans le code source.

Pour exécuter une recherche plus avancée, vous pouvez utiliser l'onglet Rechercher un symbole de la fenêtre Rechercher et remplacer. Les résultats s'affichent dans la fenêtre Résultats de la recherche de symbole. Pour plus d'informations, consultez Rechercher un symbole, fenêtre Rechercher et remplacer et Fenêtre Résultats de la recherche de symbole.

Notes

En cliquant avec le bouton droit sur un symbole dans le volet Objets de l'Explorateur d'objets, puis en cliquant sur Rechercher toutes les références, vous affichez également les résultats dans la fenêtre Résultats de la recherche de symbole.

Vous pouvez également rechercher la définition d'origine d'un élément de code en cliquant avec le bouton droit sur une instance de l'élément dans l'éditeur, puis en cliquant sur Atteindre la définition.

Recherche de symboles à l'aide de l'Explorateur d'objets

Lorsque vous tapez une chaîne de recherche dans la zone Rechercher de l'Explorateur d'objets, la recherche est effectuée uniquement dans la portée d'exploration actuelle. Utilisez la liste Parcourir pour sélectionner une portée d'exploration. Pour plus d'informations sur la façon de définir les zones de recherche, consultez Comment : modifier la portée d'exploration dans l'Explorateur d'objets.

Pour rechercher des symboles au moyen d'une chaîne de recherche dans l'Explorateur d'objets

  1. Dans l'Explorateur d'objets, dans la liste Parcourir, sélectionnez une portée d'exploration.

  2. Dans la zone Rechercher, tapez l'intégralité ou une partie d'un nom de symbole à rechercher ou sélectionnez un nom dans la liste déroulante.

    Notes

    Les recherches ne respectent pas la casse.

  3. Cliquez sur Rechercher.

    Le volet Objets affiche uniquement les noms de symboles de la portée d'exploration qui incluent la chaîne de recherche. La chaîne est mise en surbrillance dans chaque correspondance.

Pour effacer les résultats

  • Dans l'Explorateur d'objets, cliquez sur le bouton Effacer la recherche dans la barre d'outils.

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

Recherche de symboles à l'aide de la fonctionnalité Naviguer vers

La fonctionnalité Naviguer vers vous permet de rechercher un emplacement spécifique dans la solution et d'y accéder, ou encore d'explorer les éléments de la solution. Elle vous aide à recueillir un ensemble approprié de correspondances à partir d'une requête.

Boîte de dialogue Naviguer vers

Pour rechercher des symboles ou des fichiers avec la fonctionnalité Naviguer vers

  1. Dans le menu Edition, cliquez sur Naviguer vers.

  2. Dans la zone supérieure, tapez une chaîne de recherche.

    Notez que les résultats s'affichent dans la zone inférieure à mesure que vous tapez et changent lorsque vous entrez de nouveaux caractères. Par exemple, si vous tapez Click, tous les noms de symboles qui contiennent « Click » s'affichent ; toutefois, si vous ajoutez un espace et la lettre E, la liste est filtrée pour afficher uniquement les symboles qui incluent « Click » et « E » (l'espace est considéré comme une relation and).

Les résultats de la recherche peuvent inclure des définitions de symbole et des noms de fichiers de la solution, mais ne comportent pas d'espaces de noms ou de variables locales.

Une chaîne de recherche peut contenir plusieurs termes de recherche, qui doivent être séparés par des espaces. Si un terme de recherche contient une lettre majuscule, la recherche respectera la casse ; en dehors de cela, la recherche ne respecte pas la casse. La casse n'est jamais respectée pour les premiers caractères des noms de fichiers.

Vous avez la possibilité de rechercher des mots clés contenus dans un symbole en utilisant la casse mixte et des traits de soulignement pour diviser le symbole en mots clés. Par exemple, pour localiser un symbole « AddOrderHeader », vous pouvez rechercher « add », « order », « header », « order add », « AOH » et d'autres combinaisons, comme indiqué dans le tableau suivant.

Nom de symbole

Mots clés associés

Exemples de chaînes de recherche correspondantes

AddOrderHeader

Add, Order, Header

« add », « order », « header », « order add », « AOH », « a o », « add ord », « OrderH »

update_customer

update, customer

« update », « customer », « customer upd », « update c »

La syntaxe de la fonctionnalité Naviguer vers ne prend pas en charge les logiques particulières ou les caractères spéciaux tels que ceux-ci :

  • Correspondances génériques

  • Opérateurs de logique booléens (par exemple, and, or, &, |)

  • Expressions régulières

Vous pouvez double-cliquer sur un résultat pour afficher la définition dans le code.

Pour effectuer une requête améliorée, utilisez Rechercher un symbole.

Recherche de symboles à l'aide de la fonctionnalité Rechercher un symbole

Utilisez l'onglet Rechercher un symbole de la fenêtre Rechercher et remplacer pour localiser les lignes de code de votre projet où un symbole est défini, référencé ou utilisé. La fonctionnalité Rechercher un symbole est particulièrement utile pour effectuer les opérations suivantes :

  • Rechercher la définition d'un symbole ou identifier 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 de façon à découvrir leurs fonctionnalités.

L'utilisation de la fonctionnalité Rechercher un symbole se distingue de la recherche de texte comme suit :

  • La fonctionnalité Rechercher un symbole vous permet de limiter l'étendue de recherche aux symboles uniquement.

  • Indique toutes les définitions disponibles pour le symbole et les références à ce dernier dans la fenêtre Résultats de la recherche de symbole.

  • Permet d'effectuer des recherches dans les composants externes pour lesquels vous ne disposez pas du code source.

Pour rechercher des symboles au moyen d'une chaîne de recherche dans l'onglet Rechercher un symbole de la fenêtre Rechercher et remplacer

  1. Extrayez tous les fichiers à examiner qui sont stockés sous contrôle de code source.

  2. Faites passer tous les documents ouverts en mode Source.

  3. Dans le menu Edition, cliquez sur Rechercher et remplacer, puis sur Rechercher un symbole.

  4. Dans la liste Regarder dans, sélectionnez l'une des étendues de recherche suivantes.

    • Tous les composants limite la recherche à l'ensemble des composants disponibles, y compris la solution en cours, ses composants référencés, la bibliothèque de classes .NET Framework et tous les composants que vous avez ajoutés au moyen de la fonctionnalité Ajouter d'autres composants.

    • .NET Framework limite la recherche à la bibliothèque de classes .NET Framework.

    • Ma solution limite la recherche aux noms de symboles qui sont définis ou référencés dans la solution ouverte.

    • Jeu de composants personnalisés (Explorateur d'objets) limite la recherche aux composants actuellement ajoutés à l'étendue de recherche Jeu de composants personnalisés de l'Explorateur d'objets.

    • Jeu de composants personnalisés (Rechercher un symbole) limite la recherche aux composants actuellement ajoutés à l'étendue de recherche Jeu de composants personnalisés de l'onglet Rechercher un symbole.

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

  5. Sous Options de recherche, définissez les options souhaitées comme suit :

    • Mot complet filtre les résultats afin d'afficher uniquement ceux qui ne contiennent que la chaîne de recherche. Par exemple, la recherche de MyObject retourne « MyObject », mais pas « CMyObject » ni « MyObjectC ».

    • Préfixe filtre les résultats afin d'afficher uniquement ceux qui commencent par la chaîne de recherche. Par exemple, la recherche de MyObject retourne « MyObject » et « MyObjectTest », mais pas « CMyObject ».

    • Sous-chaîne retourne tous les résultats qui contiennent la chaîne de recherche. Par exemple, la recherche de MyObject retourne « MyObject », « MyObjectTest » et « CMyObject ».

    Avec chacune de ces options, vous pouvez également sélectionner Respecter la casse. Cette option filtre davantage les résultats afin d'afficher uniquement ceux qui respectent la casse de la chaîne de recherche. Par exemple, la recherche de MyObject avec l'option Respecter la casse sélectionnée retourne « MyObject », mais pas « myobject » ni « MYOBJECT ».

    Notes

    Les paramètres Rechercher et remplacer demeurent effectifs d'une recherche à l'autre. Pour plus d'informations, consultez Rechercher un symbole, fenêtre Rechercher et remplacer.

  6. Dans la zone Rechercher, entrez la chaîne ou l'expression à rechercher.

    Notes

    Les caractères génériques et les expressions régulières ne peuvent pas être utilisés dans les recherches Rechercher un symbole.

  7. Cliquez sur Rechercher tout pour commencer la recherche.

    Les résultats s'affichent dans la Fenêtre Résultats de la recherche de symbole. Vous pouvez double-cliquer sur un résultat pour accéder à sa correspondance dans le code.

Dans l'éditeur, pour rechercher la définition d'origine d'un élément de code, cliquez avec le bouton droit sur l'élément, puis cliquez sur Atteindre la définition. Vous pouvez rechercher des éléments tels que les membres, les types, les variables, les variables locales, etc.

La fonctionnalité Atteindre la définition utilise les informations de compilateur pour localiser et afficher la définition d'origine même si votre code fait appel à des surcharges ou des inférences de type, à condition que l'emplacement soit accessible à Visual Studio.

Pour rechercher la définition d'un élément de code

  • Dans l'éditeur, cliquez avec le bouton droit sur l'élément de code dont vous souhaitez rechercher la définition, puis cliquez sur Atteindre la définition.

    Le module dans lequel le code a été initialement défini, s'il est disponible, s'affiche dans un nouvel onglet de l'éditeur. Si la définition n'est pas disponible, un message d'erreur s'affiche.

Voir aussi

Tâches

Comment : naviguer dans l'Explorateur d'objets

Référence

Fenêtre Résultats de la recherche de symbole

Rechercher un symbole, commande

Fenêtre Définition de code

Autres ressources

Comment : utiliser la mise en surbrillance des références

Historique des modifications

Date

Historique

Motif

Août 2010

Modification des informations relatives à la fonctionnalité Naviguer vers.

Résolution des bogues de contenu.