Funktionale Codesuche
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019 | TFS 2018
Die Funktionscodesuche erweitert Ihre Fähigkeit, Ihre Suche über Repositorys hinweg zu verfeinern, die in Erste Schritte mit der Suche dokumentiert ist. Zum Ausführen von Codesuchen muss die Marketplace-Erweiterung Codesuche für Ihre organization oder Sammlung installiert sein.
Voraussetzungen
- Installieren der Codesuche
Weitere Informationen finden Sie unter Installieren und Konfigurieren der Suche.
- Um die Codesuche verwenden zu können, müssen Sie mindestens über Standardzugriff verfügen.
- Benutzer mit Stakeholderzugriff haben keinen Zugriff auf Code, sodass sie nicht nach Code suchen können.
- Benutzer mit Stakeholderzugriff für ein öffentliches Projekt haben vollen Zugriff auf Code, sodass sie nach Code suchen können. Um auf Code in einem privaten Projekt zuzugreifen, müssen Sie mindestens über Standardzugriff verfügen.
- Wenn Sie im organization oder in der Sammlung suchen, werden nur Ergebnisse aufgeführt, auf die ein Projektmitglied Zugriff hat.
Bewährte Methoden für die Codesuche
- Erhalten Sie die gewünschten Ergebnisse noch schneller, indem Sie mit einer suche auf höherer Ebene beginnen. Sie können Die Suche einschränken, indem Sie Projekt, Repository, Pfad, Dateinamen und andere Filteroperatoren verwenden.
- Wenn Sie sich nicht sicher sind, nach dem genauen Begriff Sie suchen, verwenden Sie Feldhalter, um Ihre Suche zu erweitern , und boolesche Operatoren, um sie zu optimieren.
- Weitere Informationen zu einem interessanten Element finden Sie schneller und mit minimalem Aufwand. Wenn Sie ein interessantes Element finden, platzieren Sie den Cursor darauf, und verwenden Sie das Kontextmenü, um in allen Projekten und Dateien schnell nach diesem Text zu suchen.
- Verfolgen Sie einfach, wie Ihr Code funktioniert, indem Sie das Kontextmenü verwenden, um nach verwandten Elementen wie Definitionen und Verweisen zu suchen – direkt aus einer Datei oder aus den Suchergebnissen.
- Gehen Sie schnell zur Implementierung einer API, von der Ihr Code möglicherweise abhängig ist, indem Sie Ihre Ergebnisse auf genaue Codetyp-Übereinstimmungen beschränken. Verwenden Sie Codetypfilter, um nach bestimmten Arten von Code zu suchen, z. B.:
- definitions
- references
- functions
- comments
- Zeichenfolgen
- Namespaces und mehr.
Hinweis
Sie können keinen Code in forkierten Repositorys durchsuchen.
Funktionen zum Suchen nach bestimmten Codetypen
Wenn Sie ihre Suche eingeben, wählen Sie Funktionen und Schlüsselwörter aus der Dropdownliste aus, um Ihre Abfrage schnell zu erstellen. Verwenden Sie den Link Weitere anzeigen , um alle verfügbaren Funktionen und Schlüsselwörter anzuzeigen. Mischen Sie die Funktionen nach Bedarf, und stimmen Sie sie ab.
Sie können auch einen oder eine Kombination von Filtern aus der Liste in der linken Spalte auswählen. Auch hier zeigt der Link Mehr anzeigen alle verfügbaren Funktionen und Schlüsselwörter an.
Stattdessen können Sie die Funktionen und Parameter direkt in die Suche eingeben. Die folgende Tabelle enthält eine Liste der Funktionen zum Auswählen bestimmter Typen oder Member in Ihrem C#-, C-, C++-, Java- und Visual Basic.NET Code.
| So suchen Sie code where findThis erscheint als ... | ... argument arg:findThis suchen |
|---|---|
| Argument | arg:findThisDeprecated in July 2019 |
| Basistyp | basetype:findThis |
| Aufrufen der Funktion | caller:findThisDeprecated in July 2019 |
| Klassendefinition oder -deklaration | class:findThis |
| Klassendeklaration | classdecl:findThisMerged with class: |
| Klassendefinition | classdef:findThisMerged with class: |
| Kommentar | comment:findThis |
| Konstruktor | ctor:findThisMerged with method: |
| Deklaration | decl:findThis |
| Definition | def:findThis |
| Destruktor | dtor:findThisMerged with method: |
| Enumerator | enum:findThis |
| Extern | extern:findThisDeprecated in July 2019 |
| Feld | field:findThis |
| Friend-Funktion | friend:findThisDeprecated in July 2019 |
| Funktion | func:findThisMerged with method: |
| Funktionsdeklaration | funcdecl:findThisMerged with method: |
| Funktionsdefinition | funcdef:findThisMerged with method: |
| Global | global:findThisDeprecated in July 2019 |
| Header | header:findThisDeprecated in July 2019 |
| Schnittstelle | interface:findThis |
| Makro | macro:findThis |
| Makrodefinition | macrodef:findThisMerged with macro: |
| Makroreferenz | macroref:findThisMerged with macro: |
| Methode | method:findThis |
| Methodendeklaration | methoddecl:findThisMerged with method: |
| Methodendefinition | methoddef:findThisMerged with method: |
| Namespace | namespace:findThis |
| Eigenschaft | prop:findThis |
| Verweis | ref:findThis |
| Zeichenfolgenliteral | strlit:findThis |
| Struktur | struct:findThisMerged with type: |
| Strukturdeklaration | structdecl:findThisMerged with type: |
| Strukturdefinition | structdef:findThisMerged with type: |
| Vorlagenargument | tmplarg:findThisDeprecated in July 2019 |
| Vorlagenspezifikation | tmplspec:findThisDeprecated in July 2019 |
| type | type:findThis |
| TypeDef | typedef:findThisMerged with type: |
| Union | union:findThisDeprecated in July 2019 |
Funktionen zum Auswählen von Projekten, Repositorys, Pfaden und Dateien
Funktionen erleichtern es, die Suche auf bestimmte Speicherorte, bestimmte Dateitypen innerhalb dieser Speicherorte oder angegebene Dateinamen einzugrenzen. Schränken Sie die Suche mit den projFiltern , repooder path auf einen bestimmten Speicherort ein. Mischen Sie die Funktionen nach Bedarf, und stimmen Sie sie ab.
| Verwendung | Beispiel |
|---|---|
| Suchen Sie alle Vorkommen des Worts QueueJobsNow im Fabrikam-Projekt. | QueueJobsNow proj:Fabrikam |
| Suchen Sie alle Vorkommen des Worts QueueJobsNow im Contoso-Repository. | QueueJobsNow repo:Contoso |
| Suchen Sie alle Vorkommen des Worts QueueJobsNow im Pfad VisualStudio/Services/Framework und seinen Unterpfaden. | QueueJobsNow path:VisualStudio/Services/Framework |
| Schließen Sie das Argument in doppelte Anführungszeichen in den Filter ein, wenn es ein Leerzeichen enthält. | QueueJobsNow path:"VisualStudio/Windows Phones and Devices/Services" |
| Suchen Sie alle Vorkommen des Worts QueueJobsNow in allen Dateien, in denen der Dateiname mit queueRegister beginnt. | QueueJobsNow file:queueRegister* |
| Suchen Sie alle Dateien mit dem Namen QueueRegister ohne Erweiterung. Verwenden Sie Anführungszeichen, um Dateien ohne Erweiterungen zu finden. | file:"queueRegister" |
| Suchen Sie alle Vorkommen des Worts QueueJobsNow nur in C#-Quelldateien. Eine Nur-Text-Suchzeichenfolge, die keine Dateitypfunktionen enthält, findet auch Dateien, bei denen die Zeichenfolge mit einem Teil des Dateinamens übereinstimmt. | QueueJobsNow ext:cs |
Suchen nach verwandten Elementen oder anderen Begriffen
Eines der leistungsstarken Features der Codesuche ist die Möglichkeit, Ihre Suche interaktiv zu erweitern, basierend auf den Ergebnissen früherer Suchvorgänge. Beispielsweise können Sie Ihre Suche beim Nachverfolgen oder Debuggen von Code einfach auf verwandte Dateien erweitern.
Platzieren Sie die Einfügemarke auf einen Begriff in der Datei, und öffnen Sie das Kontextmenü (Maus: Klicken mit der rechten Maustaste), um eine neue Suche nach anderen Dateien zu starten, die den ausgewählten Ausdruck enthalten. Sie können als Text, nach der Definition suchen, wenn Sie einen Objektnamen auswählen, oder nach Verweisen auf ein ausgewähltes Objekt.
Weitere Informationen zu den folgenden Suchfunktionen finden Sie unter Erste Schritte mit der Suche.
- Schlüsselwort
- Genaue Übereinstimmung
- Platzhalter
- Boolesche Operatoren
- Nähe
Weitere Codesuchvorgänge
Sehen Sie sich die folgenden Beispiele für noch mehr Codesuchefunktionen an. Sie können die Codetypsuchfunktionen mit Dateien verwenden, die in C#, C,C++, Java und Visual Basic.NET geschrieben wurden. Öffnen Sie die Suchergebnisse in einer neuen Browserregisterkarte im suchfeld Standard, und klicken Sie auf STRG + EINGABETASTE. Klicken Sie in Google Chrome auf STRG + UMSCHALTTASTE + , um den Fokus auf die neue Browserregisterkarte zu wechseln.
| Verwendung | Beispiel |
|---|---|
| Suchen aller Instanzen von "ToDo"-Kommentaren in Ihrem Code | Auswählen comment: und Eingeben todo |
| Suchen an bestimmten Speicherorten, z. B. innerhalb eines bestimmten Pfads | Verwenden einer Suchzeichenfolge, z. B. Driver path:MyShuttle/Server |
| Suchen nach Dateien nach Namen oder nur nach Dateierweiterung | Driver file:GreenCabs.cs. Die Suchzeichenfolge error ext:resx kann nützlich sein, wenn Sie alle Fehlerzeichenfolgen im Code überprüfen möchten. Auch wenn Ihre Nur-Text-Suchzeichenfolge mit einem Teil eines Dateinamens übereinstimmt, wird die Datei in der Liste der gefundenen Dateien angezeigt. Diese Suche funktioniert, ohne dass bestimmte Dateitypfunktionen übereinstimmen. |
Durchsuchen von Git-Projekten und Repositorys
In einem Git-Projekt wird eine Liste der darin enthaltenen Repositorys angezeigt. Verwenden Sie die Kontrollkästchen Projekt und Repository, um Ihre Suche zu erweitern. Sie können mehr oder alle Projekte durchsuchen oder Ihre Suche auf weniger Projekte und Repositorys beschränken. Wenn mehrere Projekte oder Repositorys vorhanden sind, verwenden Sie den Link Mehr anzeigen , um sie alle anzuzeigen.
Die Codesuche kann mehrere Branches in einem Git-Repository indizieren. Standardmäßig werden Dateien nur in den Standardbranch Ihrer Git-Repositorys indiziert. Ihr Standardbranch ist normalerweise der Standard Branch. Geben Sie die Branches für jedes Repository an, und indizieren Sie sie auf der Registerkarte Optionen des Abschnitts Repositorys auf der Seite Projekteinstellungen.
TFVC-Projekte durchsuchen
In einem TFVC-Projekt wird eine Liste der Ordnerpfade in diesem Projekt angezeigt, für die Sie Lesezugriff haben. Es werden keine Projekte und Ordner angezeigt, für die Sie keine Leseberechtigung haben. Wählen Sie Pfade in der Ordnerstruktur aus, um Die Suche bei Bedarf einzugrenzen.
Tipp
Die Codesuche speichert Ihre letzten Einstellungen, z. B. das Projekt und das Repository oder den Pfad, in dem Sie durchsucht haben. Deaktivieren Sie die Kontrollkästchen, um problemlos in allen Projekten zu suchen, wenn Sie alle Links löschen , wenn Sie in einem anderen Bereich suchen möchten. Im Ergebnisbereich hebt die Codesuche bis zu den ersten 100 Treffern oder Übereinstimmungen hervor, die in den Zieldateien gefunden wurden.
Suchcode mit DER REST-API
Sie können APIs verwenden, um die in diesem Artikel aufgeführten Funktionen zu erweitern oder zu ergänzen. Informationen zur Codesuche mit der REST-API finden Sie unter Abrufen von Codesuchergebnissen.