Ermitteln von Änderungen am Code und andere Verläufe mit CodeLens

Gilt für:yes Visual Studio noVisual Studio für Mac noVisual Studio Code

Mit CodeLens können Sie sich auf Ihre Arbeit konzentrieren, während Sie herausfinden, was mit Ihrem Code passiert ist– ohne den Editor verlassen zu müssen. Suchen Sie Verweise auf Codeabschnitte und -änderungen, verknüpfte Fehler, Arbeitselemente, Code Reviews und Komponententests.

Hinweis

CodeLens ist in Visual Studio Community Edition verfügbar. Die Indikatoren für die Quellcodeverwaltung sind in der Visual Studio Community Edition jedoch nicht verfügbar.

Sehen Sie, wo und wie die einzelnen Codeausschnitte in der Projektmappe verwendet werden:

CodeLens indicators in the code editor

Diskutieren Sie die Codeänderungen mit Ihrem Team, ohne den Editor verlassen zu müssen:

CodeLens - Contact your team

Um die Indikatoren auswählen, die Sie anzeigen möchten, oder CodeLens zu aktivieren bzw. deaktivieren, navigieren Sie zu Extras>Optionen>Text-Editor>Alle Sprachen>CodeLens.

Referenzen zu Ihrem Code finden

Sie können Verweise in C#- oder Visual Basic-Code suchen.

  1. Klicken Sie auf den Indikator Verweise, oder drücken Sie ALT+2.

    CodeLens references

    Hinweis

    Wenn der Indikator 0 Verweise anzeigt, bedeutet dies lediglich, dass Sie über keine Verweise aus C#- oder Visual Basic-Code verfügen. Allerdings können Verweise immer noch in anderen Elementen vorhanden sein, z.B. in XAML- und ASPX-Dateien.

  2. Zeigen Sie mit dem Mauszeiger auf den Verweis in der Liste, um den verweisenden Code anzuzeigen.

    CodeLens - Peek reference

  3. Führen Sie einen Doppelklick auf den Verweis aus, um die Datei zu öffnen, die den Verweis enthält.

Codezuordnungen

Erstellen Sie eine Code Map, um die Beziehungen zwischen dem Code und seinen Verweisen anzuzeigen. Wählen Sie im Code Map-Kontextmenü Alle Verweise anzeigen aus.

CodeLens - References on code map

Suchen nach Änderungen im Code

Überprüfen Sie den Codeverlauf, um zu ermitteln, was mit Ihrem Code geschehen ist. Sie können die Änderungen auch überprüfen, bevor sie mit Ihrem Code zusammengeführt werden. Auf diese Weise können Sie besser beurteilen, wie sich Änderungen in anderen Verzweigungen möglicherweise auf Ihren Code auswirken.

Erforderlich:

  • Visual Studio Enterprise- oder Professional-Edition

  • Azure DevOps Services, Team Foundation Server 2013 oder höher, Azure DevOps Services oder Git

  • Microsoft Teams oder Skype for Business für das Kontaktieren Ihres Teams aus dem Code-Editor

Detaillierte Informationen zu CodeLens für C#- oder Visual Basic-Code, der mit der Team Foundation-Versionskontrolle (TFVC) oder Git gespeichert ist, finden Sie auf den Klassen- und Methodenebenen (Codeindikatoren auf Elementebene). Wenn Ihr Git-Repository in TfGit gehostet ist, finden Sie auch Links zu TFS-Arbeitselementen.

Code element-level indicators

Bei anderen Dateitypen als CS oder VB erhalten Sie detaillierte Informationen zu CodeLens für die gesamte Datei am unteren Rand des Fensters (Indikatoren auf Dateiebene).

File-level CodeLens indicators

Codeindikatoren auf Elementebene

Codeindikatoren auf Elementebene zeigen Ihnen an, wer welche Änderungen an Ihrem Code vorgenommen hat. Codeindikatoren auf Elementebene sind für C#- und Visual Basic-Code verfügbar.

Wenn Sie die Team Foundation-Versionskontrolle (TFVC) in Team Foundation Server oder Azure DevOps Services verwenden, wird die folgende Ansicht angezeigt:

CodeLens: Get change history for your code in TFVC

Der Standardzeitraum umfasst die letzten 12 Monate. Wenn Ihr Code in Team Foundation Server gespeichert ist, können Sie den Zeitraum ändern, indem Sie den TFSConfig-Befehl mit dem CodeIndex-Befehl und dem Flag /indexHistoryPeriod ausführen.

Zum Anzeigen eines ausführlichen Verlaufs aller Änderungen, einschließlich der von vor über einem Jahr, wählen Sie Alle Dateiänderungen anzeigen aus:

Show all code changes

Das Fenster Versionsgeschichte wird geöffnet:

History window for all code changes

Wenn Ihre Dateien sich in einem Git-Repository befinden und Sie den Codeindikator für Änderungen auf Elementebene auswählen, wird Folgendes angezeigt:

CodeLens: Get change history for your code in Git

Indikatoren auf Dateiebene

Suchen Sie in den Indikatoren auf Dateiebene am unteren Rand des Fensters nach Änderungen für eine gesamte Datei:

CodeLens: Get code file details

Hinweis

Indikatoren auf Dateiebene sind für C#- und Visual Basic-Dateien nicht verfügbar.

Um weitere Details zu einer Änderung zu erhalten, klicken Sie mit der rechten Maustaste auf dieses Element. Abhängig davon, ob Sie TFVC oder Git verwenden, stehen Ihnen mehrere Optionen zum Vergleichen der Dateiversionen, zum Anzeigen detaillierter Informationen und zum Nachverfolgen von Änderungen, zum Abrufen der ausgewählten Dateiversion und zum Senden einer E-Mail an den Autor einer Änderung zur Verfügung. Einige dieser Details werden im Team-Explorer in Visual Studio 2019 Version 16.7 und früher angezeigt. In Visual Studio 2019 Version 16.8 und höher werden diese Details unter Git Changes angezeigt.

Sie können auch sehen, wer den Code in einem bestimmten Zeitraum geändert hat. Dadurch können Sie Muster bei den Änderungen Ihres Teams erkennen und ihre Auswirkung bewerten.

CodeLens: See code changes history as a graph

Änderungen in der aktuellen Verzweigung finden

Möglicherweise verfügt Ihr Team über mehrere Branches, z.B. einen Hauptbranch und einen untergeordnete Entwicklungsbranch, um das Risiko von Schäden an stabilem Code zu verringern.

CodeLens: Find changes in your current branch

Sie können herausfinden, wie viele Personen Ihren Code geändert haben und wie viele Änderungen am Hauptbranch vorgenommen wurden, indem Sie ALT+6 drücken:

CodeLens: Find how many changes in your branch

Sehen, wann Ihr Code verzweigt wurde

Navigieren Sie im untergeordneten Branch zu Ihrem Code, um herauszufinden, wann Ihr Code gebrancht wurde. Klicken Sie dann auf den Indikator Änderungen, oder drücken Sie ALT+6:

CodeLens: Find when your code was branched

Eingehende Änderungen aus anderen Verzweigungen sehen

CodeLens: Find code changes in other branches

Sie können eingehende Änderungen anzeigen. Im folgenden Screenshot wurde ein Fehler im Branch „Dev“ behoben:

CodeLens: Change checked into another branch

Sie können die Änderung überprüfen, ohne den aktuelle Branch zu verlassen (Hauptbranch):

CodeLens: See incoming change from another branch

Herausfinden, wann Änderungen zusammengeführt wurden

Sie können sehen, wann die Änderungen zusammengeführt wurden, sodass Sie ermitteln können, welche Änderungen in Ihrem Branch enthalten sind:

CodeLens - Find when changes got merged

Zum Beispiel enthält der Code im Hauptbranch jetzt die Fehlerkorrektur des Branches „Dev“:

CodeLens - Merged changes between branches

Vergleichen einer eingehenden Änderung mit der lokalen Version

Vergleichen Sie eine eingehende Änderung mit Ihrer lokalen Version, in dem Sie UMSCHALT+F10 drücken oder einen Doppelklick auf das Changeset ausführen.

CodeLens: Compare incoming change with local

Symbole für Branches

Das Symbol in der Spalte Branch gibt die Beziehung des Branches zu dem Branch an, in dem Sie arbeiten.

Symbol: Ursprung der Änderung:
CodeLens: Change from current branch icon Die aktuelle Verzweigung
CodeLens: Change from parent branch icon Die übergeordnete Verzweigung
CodeLens: Change from child branch icon Eine untergeordnete Verzweigung
CodeLens: Change from peer branch icon Eine Peerverzweigung
CodeLens: Change from branch further away icon Eine Verzweigung, die sich weiter entfernt befindet als über- oder untergeordnet und Peer
CodeLens: Merge from parent icon Eine Zusammenführung von der übergeordneten zu einer untergeordneten Verzweigung
CodeLens: Merge from child branch icon Eine Zusammenführung von der untergeordneten zu einer übergeordneten Verzweigung
CodeLens: Merge from unrelated branch icon Eine Zusammenführung von einer nicht verwandten Verzweigung (Zusammenführung ohne Basis)

Verknüpfte Arbeitselemente

Suchen Sie verknüpfte Arbeitselemente, indem Sie auf den Indikator Arbeitselemente klicken oder ALT+8 drücken.

CodeLens - Find work items for specific code

Verknüpfte Code Reviews

Suchen Sie verknüpfte Code Reviews, indem Sie auf den Indikator Reviews klicken. Halten Sie die ALT-Taste gedrückt, und drücken Sie dann die NACH-LINKS-TASTE oder die NACH-RECHTS-TASTE, um die Indikatoroptionen mit der Tastatur zu navigieren.

CodeLens - View code review requests

Verknüpfte Fehler

Suchen Sie verknüpfte Fehler, indem Sie auf den Indikator Fehler klicken oder ALT+7 drücken.

CodeLens - Find bugs linked to changesets

Den Besitzer eines Elements kontaktieren

Suchen Sie den Autor eines Elements, indem Sie auf den Indikator Autoren klicken oder ALT+5 drücken.

Contact the owner of an item

Öffnen Sie das Kontextmenü für ein Element, um die Kontaktoptionen anzuzeigen. Wenn Sie Lync, Skype for Business oder Teams installiert haben, werden Optionen ähnlich wie im folgenden Screenshot angezeigt:

Contact options for an item

Zugehörige Komponententests

Sie können weitere Komponententests für Ihren C#- oder Visual Basic-Code ermitteln, ohne den Test-Explorer öffnen zu müssen.

  1. Navigieren Sie zum Anwendungscode, der über zugehörigen Komponententestcode verfügt.

  2. Falls Sie Ihre Anwendung noch nicht erstellt haben, holen Sie dies nach, um die CodeLens-Testindikatoren zu laden.

  3. Überprüfen Sie die Tests für den Code, indem Sie ALT+3 drücken.

    CodeLens - Choose test status in code editor

  4. Wenn ein Warnungssymbol warning iconangezeigt wird, werden die Tests noch nicht ausgeführt, sodass sie ausgeführt werden.

    CodeLens - View unit tests not run yet

  5. Zum Überprüfen der Definition eines Tests doppelklicken Sie im CodeLens-Indikatorfenster auf das Testelement, um die Codedatei im Editor zu öffnen.

    CodeLens - Go to unit test definition

  6. Um die Ergebnisse des Tests zu überprüfen, wählen Sie die Teststatusanzeige (test failed icon oder ) aus test passed icon, oder drücken Sie ALT+1.

    CodeLens - See unit test result

  7. Zum Überprüfen, wie viele Personen diesen Test geändert haben, wer ihn geändert hat oder wie viele Änderungen an diesem Test durchgeführt wurden, ermitteln Sie den Codeverlauf und verknüpfte Elemente.

Tastenkombinationen

Drücken und halten Sie zum Auswählen von Indikatoren über die Tastatur die ALT-Taste, um die zugehörigen Nummerntasten anzuzeigen, und drücken Sie dann die Nummer, die dem Indikator entspricht, den Sie auswählen möchten.

Keyboard access numbers

Hinweis

Halten Sie die ALT-Taste gedrückt, und verwenden Sie die Pfeiltasten zum Navigieren, um den Indikator Reviews auszuwählen.

Fragen und Antworten (Q & A)

Frage: Wie aktiviere oder deaktiviere ich CodeLens, bzw. wie wähle ich die anzuzeigenden Indikatoren aus?

Eine: Sie können Indikatoren außer dem Bezügeindikator deaktivieren oder aktivieren. Navigieren Sie zu Extras>Optionen>Text-Editor>Alle Sprachen>CodeLens.

Wenn die Indikatoren aktiviert wurden, können Sie die CodeLens-Optionen auch über die Indikatoren öffnen.

CodeLens - Turn indicators off or on

Aktivieren bzw. deaktivieren Sie CodeLens-Indikatoren auf Dateiebene mithilfe der Chevron-Symbole unten im Editor-Fenster.

Turn file-level indicators on and off

F: Wo befindet sich CodeLens?

A: CodeLens wird in C#- und Visual Basic-Code auf der Methoden-, Klassen-, Indexer- und Eigenschaftsebene angezeigt. CodeLens wird auf Dateiebene für alle anderen Dateitypen angezeigt.

  • Stellen Sie sicher, dass CodeLens aktiviert ist. Navigieren Sie zu Extras>Optionen>Text-Editor>Alle Sprachen>CodeLens.

  • Wenn Ihr Code in TFS gespeichert ist, stellen Sie sicher, dass die Codeindizierung aktiviert ist. Verwenden Sie hierzu den CodeIndex-Befehl mit dem TFSConfig-Befehl.

  • DevOps-bezogene Indikatoren werden nur angezeigt, wenn Arbeitselemente mit dem Code verknüpft sind und Sie über Berechtigungen zum Öffnen verknüpfter Arbeitselemente verfügen. Stellen Sie sicher, dass Sie über Teammitgliedsberechtigungen verfügen.

  • Komponententestindikatoren werden nicht angezeigt, wenn der Anwendungscode nicht über Komponententests verfügt. Teststatusindikatoren werden automatisch in Testprojekten angezeigt. Wenn Sie wissen, dass der Anwendungscode über Komponententests verfügt, die Testindikatoren jedoch nicht angezeigt werden, versuchen Sie, die Projektmappe zu erstellen (STRG+UMSCHALT+B).

Tipp

CodeLens ist in Visual Studio Community Edition verfügbar. Die Indikatoren für die Quellcodeverwaltung sind in der Visual Studio Community Edition jedoch nicht verfügbar.

F: Warum sehe ich keine Arbeitselementdetails für einen Commit?

A: Dies kann passieren, wenn CodeLens die Arbeitselemente in Azure Boards oder TFS nicht finden kann. Stellen Sie sicher, dass Sie mit dem Projekt verbunden sind, das diese Arbeitselemente enthält, und dass Sie über die erforderlichen Berechtigungen verfügen, diese Arbeitselemente anzuzeigen. Arbeitselementdetails werden möglicherweise ebenfalls nicht angezeigt, wenn die Commitbeschreibung falsche Informationen zu den Arbeitselement-IDs in Azure Boards oder TFS enthält.

F: Warum sehe ich keine Skype-Indikatoren?

A: Skype-Indikatoren werden nicht angezeigt, wenn Sie nicht bei Skype for Business angemeldet sind, es nicht installiert haben oder über keine unterstützte Konfiguration verfügen. Allerdings können Sie weiterhin E-Mails senden:

CodeLens - Contact changeset owner by mail

Welche Skype- und Lync-Konfigurationen werden unterstützt?

  • Skype for Business(32-Bit- oder 64-Bit)

  • Lync 2010 oder höher allein (32-Bit- oder 64-Bit), aber nicht Lync Basic 2013 mit Windows 8.1

CodeLens unterstützt nicht die Installation verschiedener Versionen von Lync oder Skype. Sie sind möglicherweise nicht für alle lokalisierten Versionen von Visual Studio lokalisiert.

F: Wie ändere ich Schriftart und Farbe für CodeLens?

A: Navigieren Sie zu Extras>Optionen>Umgebung>Schriftarten und Farben.

CodeLens - Change font and color settings

So verwenden Sie die Tastatur:

  1. Drücken Sie ALT+T+O, um das Dialogfeld Optionen zu öffnen.

  2. Drücken Sie die NACH-OBEN-TASTE oder die NACH-UNTEN-TASTE , um zum Knoten Umgebung zu wechseln, und dann die NACH-LINKS-TASTE , um den Knoten zu erweitern.

  3. Drücken Sie die NACH-UNTEN-TASTE , um zu Schriftarten und Farbenzu wechseln.

  4. Drücken Sie die TAB-TASTE, um zur Liste Einstellungen anzeigen für zu wechseln, und drücken Sie dann die NACH-UNTEN-TASTE, um CodeLensauszuwählen.

F: Kann ich das CodeLens-Heads-up-Display verschieben?

Eine: Ja, wählen Sie Dock icon CodeLens als Fenster an.

Dock button in CodeLens indicator window

Docked CodeLens References window

F: Wie aktualisiere ich die Indikatoren?

A: Dies hängt vom Indikator ab:

  • Verweise: Dieser Indikator wird bei einer Änderung des Codes automatisch aktualisiert. Wenn der Indikator Verweise als separates Fenster angedockt ist, aktualisieren Sie den Indikator, indem Sie auf Aktualisieren klicken:

    Refresh button in CodeLens References

  • Team: Aktualisieren Sie diese Indikatoren, indem Sie im Kontextmenü auf CodeLens-Teamindikatoren aktualisieren klicken:

    Refresh CodeLens Team Indicators menu item

  • Test:Suchen von Komponententests für Ihren Code zum Aktualisieren des Indikators Test.

F: Was bedeutet „Lokale Version“?

A: Der Pfeil Lokale Version zeigt auf das neueste Changeset in der lokalen Version einer Datei. Wenn der Server über neuere Changesets verfügt, werden sie je nach Reihenfolge, in der sie sortiert sind, über oder unter dem Pfeil Lokale Version angezeigt.

F: Kann ich verwalten, wie CodeLens den Code verarbeitet, um den Verlauf und verknüpfte Elemente anzuzeigen?

A: Ja. Wenn sich der Code in TFS befindet, können Sie hierzu den CodeIndex-Befehl mit dem TFSConfig-Befehl verwenden.

F: Meine CodeLens-Testindikatoren werden beim ersten Öffnen der Projektmappe nicht mehr in meiner Datei angezeigt. Wie kann ich sie laden?

A: Erstellen Sie Ihr Projekt erneut, damit die CodeLens-Testindikatoren in Ihre Datei geladen werden. Zur Verbesserung der Leistung ruft Visual Studio beim Laden von Codedateien keine Quellinformationen mehr für Testindikatoren ab. Testindikatoren werden geladen, nachdem ein Build geladen wurde, oder wenn Sie zu einem Test navigieren, indem Sie im Test-Explorer darauf doppelklicken.

Siehe auch