CodeLens によるコード変更とその他の履歴の検索

[アーティクル]
07/19/2023

CodeLens では、エディターを離れずにコードに対する変更を把握できるため、自分の作業に専念できます。コードへの参照、コードへの変更、リンクされたバグ、Azure DevOps 作業項目、コードレビュー、単体テストを検索できます。

Note

CodeLens は Visual Studio の Community エディションで使用できますが、"ソース管理" インジケーターはこのエディションでは使用できません。

CodeLens はコードの各部分がソリューションのどこで使用されているかとどのように使用されているかの両方を表示することができます。

コードエディター内の CodeLens インジケーターのスクリーンショット。

表示するインジケーターを選択するか、CodeLens のオンとオフを切り替えるには、 [ツール] 、 [オプション] 、 [テキストエディター] 、 [すべての言語] 、 [CodeLens] の順に移動します。

コード参照の検索

C# コードまたは Visual Basic コードでの参照を検索することができます。ここではその方法を説明します。

コードエディターで、[参照] インジケーターを選択するか、Alt+2 キーを押します。

Note

インジケータの表示が 0 references である場合は、C# または Visual Basic コードの参照がないということです。ただし、.xaml ファイルや .aspx ファイルなどの他の項目の参照が存在する場合があります。
参照元コードを表示するには、リスト内の参照の上にマウスポインターを合わせます。
参照を含むファイルを開くには、参照をダブルクリックします。

コードマップ

コードとその参照の間の関係を表示するには、コードマップを作成します。コードマップのショートカットメニューで、[すべての参照の表示] を選択します。

コードに含まれる変更の検索

コードの変遷をたどるため、コードの履歴を確認します。または、他の分岐での変更がコードに与える可能性のある影響を理解できるよう、変更をコードにマージする前に、それらの変更を検討します。

必要なもの:

Visual Studio Enterprise または Visual Studio Professional
Git、Azure DevOps Server (以前は Team Foundation Server) または Team Foundation バージョン管理

Team Foundation バージョン管理 (TFVC) または Git で格納されている C# または Visual Basic コードでは、CodeLens の詳細をクラスレベルまたはメソッドレベルで取得します (コードの要素レベルのインジケーター)。

.cs または .vb 以外のファイルの種類については、ファイル全体の CodeLens の詳細を 1 つの場所 ("ファイルレベル" インジケーター) で取得します。

コードの要素レベルのインジケーター

コードの要素レベルのインジケーターでは、コードの変更者とその変更内容を確認できます。コードの要素レベルのインジケーターは、C# および Visual Basic コードに対して利用できます。

Azure DevOps Services で Team Foundation バージョン管理 (TFVC) を使用すると、変更履歴を表示することもできます。

既定の時間は直近 12 か月です。

1 年以上前の変更を含む、すべての変更の詳細な履歴を表示するには、[すべてのファイルの変更の表示] を選択します。これによって [履歴] ウィンドウが開きます。

[履歴] ウィンドウでは、Git リポジトリ内のすべてのファイルを表示できます。その後、コード要素レベル変更インジケーターを選択して詳細を確認できます。

ファイルレベルのインジケーター

ファイルレベルインジケーターを表示してファイル全体を確認することもできます。

Note

ファイルレベルのインジケーターは、C# ファイルおよび Visual Basic ファイルでは利用できません。

変更に関する詳細情報を取得するには、その項目を右クリックします。 TFVC を使用しているか Git を使用しているかに応じて、ファイルのバージョンの比較、詳細の表示と変更セットの追跡、ファイルの選択バージョンの取得、その変更の作成者へのメールといったオプションがあります。これらの詳細の一部は、 Team Explorer に表示されます 有効になっている場合は、これらの詳細は Git Changes タブに表示され、エディターの下部にある水平スクロールバーにも表示されることがあります。

また、コードを変更したユーザーを時系列で確認することもできます。これは、チームの変更のパターンを見つけて、その影響を評価するのに役立ちます。

Visual Studio 2022 バージョン 17.12 Preview 2 以降では、エディターの水平スクロールバーにファイルレベルインジケーターを表示または非表示にすることができます。インジケーターを非表示にするには、 Tools > オプション > テキストエディター > 詳細を開き、 Show ファイルレベルの CodeLens インジケーター オプションを無効にします。このオプションは、XAML、HTML、CSS などの下部のエディタースクロールバーにファイルレベルの CodeLens コントロールがあり、インライン CodeLens を含むファイルには影響しないファイルの種類の表示に影響します。

現在の分岐での変更の検索

安定したコードを損なうリスクを軽減するために、チームには複数のブランチ (たとえば、メインブランチとその子の開発ブランチなど) が存在する場合があります。メイン分岐で、コードを変更したユーザーの数と、変更の数を確認できます。それには、Alt+6キーを押します。

コードが分岐された時期の確認

コードが分岐された時期を確認するには、子分岐のコードに移動します。次に、変更インジケーターを選択するか、Alt+6 キーを押します。

他の分岐から追加される変更の検索

追加された変更を表示することができます。そのときに、変更を確認するために現在のブランチを離れる必要はありません。

変更がマージされた時期の確認

変更がいつマージされたかを確認できるので、ブランチにどの変更が含まれているかを特定できます。

追加される変更をローカルバージョンと比較します

新しい変更をローカルバージョンと比較するには、変更セットをダブルクリックするか、Shift+F10 キーを押します。

分岐アイコン

[分岐] 列のアイコンは、分岐が、作業中の分岐とどのような関係にあるのかを示します。

アイコン	変更元:
	現在の分岐
	親分岐
	子分岐
	ピア分岐
	親、子、またはピアより遠い分岐
	親分岐から子分岐へのマージ
	子分岐から親分岐へのマージ
	無関係の分岐からのマージ (ベースレスマージ)

リンクされた作業項目

リンクされた作業項目を検出するには、作業項目インジケーターを選択するか、または Alt+8 キーを押します。

リンクされたコードレビュー

リンクされたコードレビューを検出するには、レビュー インジケーターを選択します。キーボードを使用する場合は、Alt キーを押しながら左方向キーまたは右方向キーを押して、インジケーターオプション間を移動します。

リンクされているバグ

リンクされているバグを検出するには、バグインジケーターを選択するか、または Alt+7 キーを押します。

項目の所有者に連絡する

項目の所有者を確認するには、所有者インジケーターを選択するか、または Alt+5 キーを押します。

項目のショートカットメニューを開いて問い合わせのオプションを表示することもできます。 (Teams がインストールされている場合は、使用できる追加のコミュニケーションオプションがあります。)

キーボードショートカット

キーボードを使用してインジケーターを選択するには、Alt キーを押したままにして関連する数字キーを表示し、目的のインジケーターに対応する数字キーを押します。

Note

レビュー インジケーターを選択するには、Alt キーを押しながら、左方向キーと右方向キーを使用して移動します。

Q & A

Q:CodeLens を有効または無効にしたり、表示するインジケーターを選択したりするには、どうしたらいいですか。

A: 参照インジケーター以外のインジケーターは無効にも有効にもできます。 [ツール] 、 [オプション] 、 [テキストエディター] 、 [すべての言語] 、 [CodeLens] の順に進みます。

インジケーターが有効の場合は、インジケーターから CodeLens のオプションを開くこともできます。そして、エディターウィンドウの下部にあるシェブロンアイコンを使用して、CodeLens のファイルレベルインジケーターのオンとオフを切り替えることができます。

Q: CodeLens はどこにありますか。

A: CodeLens は、メソッド、クラス、インデクサー、およびプロパティレベルの C# および Visual Basic のコードで表示されます。それ以外の種類のファイルについては、ファイルレベルで CodeLens が表示されます。

CodeLens が有効になっていることを確認します。 [ツール] 、 [オプション] 、 [テキストエディター] 、 [すべての言語] 、 [CodeLens] の順に進みます。
DevOps 関連のインジケーターは、作業項目がコードにリンクされていて、リンクされた作業項目を開く権限を自分が持っている場合にだけ表示されます。チームメンバーのアクセス許可があることを確認してください。
アプリケーションコードに単体テストがない場合は、単体テストインジケーターが表示されません。テスト状態インジケーターは、テストプロジェクトに自動的に表示されます。アプリケーションコードに単体テストがあることがわかっているのに、テストインジケーターが表示されない場合は、ソリューションのビルドを試みます (Ctrl+Shift+B)。

ヒント

CodeLens は Visual Studio Community エディションで使用できますが、"ソース管理" のインジケーターはこのエディションでは使用できません。

コミットの作業項目詳細が表示されないのはなぜですか。

A: これは CodeLens が Azure Boards の作業項目を見つけることができないために発生している可能性があります。その作業項目があるプロジェクトに接続していることと、その作業項目を表示するアクセス許可があることを確認してください。作業項目の詳細は、コミットの記述に Azure Boards の作業項目 ID に関する誤った情報が含まれている場合にも、表示されない可能性があります。

Q: CodeLens のフォントと色を変更するにはどうすればよいですか。

A:[ツール] 、 [オプション] 、 [環境] 、 [フォントおよび色] の順に進みます。

CodeLens - フォントおよび色の設定の変更

キーボードを使用するには:

Alt+T+O キーを押して、 [オプション] ダイアログボックスを開きます。
上方向 キーまたは 下方向 キーを押して [環境] ノードに移動するか、 左方向 キーを押してノードを展開します。
下方向 キーを押して [フォントおよび色]に移動します。
Tab キーを押して [設定の表示] の一覧に移動し、下方向キーを押して [CodeLens] を選択します。

Q: CodeLens ヘッドアップディスプレイを移動できますか。

A: はい、できます。 [Dock] アイコンを選択して、CodeLens をウィンドウとしてドッキングします。

Q: インジケーターを更新するにはどうすればよいですか。

A: 方法は、インジケーターによって異なります。

参照: このインジケーターは、コードが変更されるときに自動的に更新されます。 [参照] インジケーターが別個のウィンドウとしてドッキングされている場合は、[更新] を選択することでインジケーターを更新します。
チーム: 右クリックメニューから [CodeLens チームインジケーターの更新] を選択することでこれらのインジケーターを更新します。
テスト: コードの単体テストを検索し、テスト インジケーターを更新します。

Q: "ローカルバージョン" とは何ですか。

A:[ローカルバージョン] 矢印は、ファイルのローカルバージョンの最新の変更セットを指しています。サーバーにさらに新しい変更セットが含まれる場合、その変更セットは、使用されている並べ替え順序に応じて [ローカルバージョン] 矢印の上または下に表示されます。

Q: ソリューションを最初に開いたときに、ファイルに CodeLens テストインジケーターが表示されなくなります。これを読み込むにはどうすればよいですか。

A: プロジェクトをリビルドし、ファイルに読み込む CodeLens テストインジケーターを取得します。パフォーマンスを向上させるため、Visual Studio では、コードファイルが読み込まれるときにテストインジケーターのソース情報がフェッチされなくなります。テストインジケーターは、ビルド後、またはテストエクスプローラーでダブルクリックしてテストに移動するときに読み込まれます。

CodeLens では、エディターを離れずにコードに関する情報を検索できるため、自分の作業に専念できます。コードの参照、コードへの変更、リンクされたバグ、作業項目、コードレビュー、単体テストを検索できます。

注意

CodeLens は Visual Studio Community エディションで使用できますが、"ソース管理" のインジケーターはこのエディションでは使用できません。

コードの各部分がソリューションのどこでどのように使用されているかをご覧ください。

コードエディター内の CodeLens インジケーター

エディターから離れずに、コードの変更についてチームに問い合わせることができます。

CodeLens - チームに連絡する