CodeLens によるコード変更とその他の履歴の検索Find code changes and other history with CodeLens

エディターを離れずにコードに関する情報を検索できるため、自分の作業に専念できます。Stay focused on your work while you find out what happened to your code - without leaving the editor. コードの参照、コードへの変更、リンクされたバグ、作業項目、コード レビュー、単体テストを検索できます。Find references and changes to your code, linked bugs, work items, code reviews, and unit tests.

注意

CodeLens は、Visual Studio Enterprise エディションと Visual Studio Professional エディションでのみ使用できます。CodeLens is available only in Visual Studio Enterprise and Visual Studio Professional editions. Visual Studio Community エディションでは使用できません。It is not available in Visual Studio Community edition.

コードの各部分がソリューションのどこでどのように使用されているかをご覧ください。See where and how the individual parts of your code are used in your solution:

コード エディター内の CodeLens インジケーターCodeLens indicators in the code editor

エディターから離れずに、コードの変更についてチームに問い合わせることができます。Contact your team about changes to your code without leaving the editor:

CodeLens - チームに連絡するCodeLens - Contact your team

表示するインジケーターを選択するか、CodeLens のオンとオフを切り替えるには、 [ツール][オプション][テキスト エディター][すべての言語][CodeLens]の順に移動します。To choose the indicators that you want to see, or to turn CodeLens off and on, go to Tools, Options, Text Editor, All Languages, CodeLens.

コード参照の検索 Find references to your code

要件:You'll need:

  • Visual Studio Enterprise または Visual Studio ProfessionalVisual Studio Enterprise or Visual Studio Professional

  • Visual C# .NET コードまたは Visual Basic .NET コードVisual C# .NET or Visual Basic .NET code

    参照 インジケーターを選択します (Alt + 2)。Choose the references indicator (Alt + 2). 参照が 1 つもない場合は、Visual C# コードまたは Visual Basic コードからの参照がないということです。If you see 0 references, you have no references from Visual C# or Visual Basic code. このインジケーターには、XAML ファイル、ASPX ファイルなどの他の項目からの参照は含まれません。This doesn't include references from other items such as XAML and ASPX files.

    CodeLens - 参照インジケーターを選択するCodeLens - Choose references indicator

    参照元コードを表示するには、参照の上にマウス ポインターを合わせます。To view the referencing code, move your mouse on top of the reference.

    CodeLens - 参照を確認するCodeLens - Peek reference

    参照を含むファイルを開くには、参照をダブルクリックします。To open the file containing the reference, double-click the reference.

    このコードと、その参照の間の関係を表示するには、コード マップを作成して、コード マップのショートカット メニューで [すべての参照の表示] を選択します。To see relationships between this code and its references, create a code map and choose Show All References in the code map shortcut menu.

    CodeLens - コード マップ上の参照CodeLens - References on code map

コードの履歴およびリンクされた項目の検索 Find your code's history and linked items

コードの変遷をたどるため、コードの履歴を確認します。Review your code's history to find out what happened to your code. または、他の分岐での変更がコードに与える可能性のある影響を理解できるよう、変更をコードにマージする前に、それらの変更を検討します。Or, review changes before they're merged into your code so you can better understand how changes in other branches might affect your code.

要件:You'll need:

  • Visual Studio Enterprise または Visual Studio ProfessionalVisual Studio Enterprise or Visual Studio Professional

  • Team Foundation Server 2013 以降、Visual Studio Team Services、または GitTeam Foundation Server 2013 or later, Visual Studio Team Services, or Git

  • Lync 2010 以降、または Skype for Business。これによりコード エディターからチームと通信できますLync 2010 or later, or Skype for Business, to contact your team from the code editor

    Team Foundation バージョン管理 (TFVC) または Git で格納されている Visual C# .NET または Visual Basic .NET コードでは、CodeLens の詳細をクラス レベルまたはメソッド レベルで取得します (code-element-level インジケーター)。For Visual C# .NET or Visual Basic .NET code that's stored with Team Foundation version control (TFVC) or Git, you get CodeLens details at the class and method levels (code-element-level indicators). Git リポジトリが TfGit でホストされている場合、TFS 作業項目へのリンクも取得します。If your Git repository is hosted in TfGit, you also get links to TFS work items.

    コードの要素レベルのインジケーターCode element-level indicators

    Visual Studio エディターで開くことができる他のすべての種類のファイルについては、ウィンドウ下部の 1 個所でファイル全体の CodeLens の詳細を取得します (file-level インジケーター)。For all other types of files that you can open in the Visual Studio editor, you get CodeLens details for the entire file in one place at the bottom of the window (file-level indicators).

    ファイル レベルの CodeLens インジケーターFile-level CodeLens indicators

    キーボードを使用してインジケーターを選択するには、 Alt キーを押した状態を保ち、関連する数値キーを表示します。To use the keyboard to select indicators, press and hold the ALT key to display the related number keys.

    Alt キーを押してキーボード アクセス番号を表示するPress ALT to see the keyboard access numbers

コードに含まれる変更の検索Find changes in your code

C# コードまたは Visual Basic コードを変更したユーザー、およびそのユーザーによって行われた変更を code-element-level インジケーターで探します。Find who changed your C# or Visual Basic code, and the changes they made, in code-element-level indicators. これは、Team Foundation Server または Visual Studio Team Services で Team Foundation バージョン管理 (TFVC) を使用するときに行います。This is what you see when you use Team Foundation version control (TFVC) in Team Foundation Server or Visual Studio Team Services.

CodeLens: TFVC で自分のコードの変更履歴を取得するCodeLens: Get change history for your code in TFVC

既定の時間は直近 12 か月です。The default time period is the last 12 months. Team Foundation Server にコードが格納される場合、 TFSConfig コマンド および /indexHistoryPeriod フラグを指定した CodeIndex コマンド を実行することにより、この制限を変更できます。If your code is stored in Team Foundation Server, you can change this by running the TFSConfig command with the CodeIndex command and the /indexHistoryPeriod flag.

1 年以上前のものを含む、すべての変更の詳細な履歴を表示するには、 [すべてのファイルの変更を表示する]を選択します。To see a detailed history of all the changes, including those from more than a year ago, choose Show all file changes.

すべてのコード変更を表示するShow all code changes

これで、変更セットの [履歴] ウィンドウが開きます。This opens the History window for the changesets.

すべてのコード変更の履歴ウィンドウHistory window for all code changes

ファイルが Git リポジトリにある場合に、code-element-level の変更インジケーターを選択すると、このように表示されます。When your files are in a Git repository and you choose the code-element-level changes indicator, this is what you see.

CodeLens: Git で自分のコードの変更履歴を取得するCodeLens: Get change history for your code in Git

ウィンドウ下部の file-level インジケーターで、ファイル全体の変更を探します (C# ファイルと Visual Basic ファイルは除く)。Find changes for an entire file (except for C# and Visual Basic files) in the file-level indicators at the bottom of the window.

CodeLens: コード ファイルの詳細を取得するCodeLens: Get code file details

変更に関する詳細情報を取得するには、その項目を右クリックします。To get more details about a change, right-click that item. TFVC を使用しているか Git を使用しているかに応じて、ファイルのバージョンの比較、詳細の表示と変更セットの追跡、ファイルの選択バージョンの取得、その変更の作成者への電子メール通知のための一連のオプションを取得します。Depending on whether you are using TFVC or Git you get a series of options to compare the versions of the file, view details and track the changeset, get the selected version of the file, and email the author of that change. チーム エクスプローラーに詳細の一部が表示されます。Some of these details appear in Team Explorer.

一定期間内にコードを変更したユーザーも表示されます。You can also see who changed your code over time. これは、チームでの変更のパターンを見つけて影響を評価するために役立ちます。This can help you find patterns in your team's changes and assess their impact.

CodeLens: コードの変更履歴をグラフで表示CodeLens: See code changes history as a graph

現在の分岐での変更の検索Find changes in your current branch

安定したコードの状態を損なわせるリスクを軽減するために、チームが複数の分岐 (メイン分岐とその下位の開発分岐) で作業しているとします。Suppose your team has multiple branches - a main branch and a child development - to reduce the risk of breaking stable code:

CodeLens: コードが分岐された時間を検索CodeLens: Find when your code was branched

メイン分岐で、コードを変更したユーザーの数と、変更の数を確認します (Alt + 6)。Find how many people changed your code and how many changes were made (Alt + 6) in your main branch:

CodeLens: この分岐での変更数を検索CodeLens: Find how many changes in your branch

コードが分岐された時期の確認Find when your code was branched

子ブランチ (たとえば、Dev 分岐) のコードに移動します。Go to your code in the child branch, for example, the Dev branch here. 変更インジケーターを選択します (Alt + 6)。Choose the changes indicator (Alt + 6):

CodeLens: コードが分岐された時間を検索CodeLens: Find when your code was branched

他の分岐から追加される変更の検索Find incoming changes from other branches

CodeLens: 別の分岐でのコード変更を検索CodeLens: Find code changes in other branches

… Dev 分岐でのこのバグ修正を例に用います。...like this bug fix in the Dev branch here:

CodeLens: 別の分岐にチェックインされた変更CodeLens: Change checked into another branch

この変更は、現在の分岐 (メイン分岐) を離れることなく検討できます。You can review this change without leaving your current branch (Main):

CodeLens: 別の分岐からの変更を表示CodeLens: See incoming change from another branch

変更がマージされた時期の確認Find when changes got merged

分岐に含まれている変更を確認することができます。So you can see which changes are included in your branch:

CodeLens - 分岐間でマージされた変更CodeLens - Merged changes between branches

たとえば、メイン分岐のコードに、Dev 分岐からのバグ修正が適用されるとします。For example, your code in the Main branch now has the bug fix from the Dev branch:

CodeLens - 分岐間でマージされた変更CodeLens - Merged chagnes between branches

追加される変更をローカル バージョンと比較します (Shift + F10)。Compare an incoming change with your local version (Shift + F10)

CodeLens: 受信した変更をローカルと比較CodeLens: Compare incoming change with local

変更セットをダブルクリックすることもできます。You can also double-click the changeset.

アイコンの意味What do the icons mean?

アイコンIcon 変更の作成元Where did the change come from?
CodeLens: [現在の分岐からの変更] アイコンCodeLens: Change from current branch icon 現在の分岐The current branch
CodeLens - [親分岐からの変更] アイコンCodeLens - Change from parent branch icon 親分岐The parent branch
CodeLens - [子分岐からの変更] アイコンCodeLens: Change from child branch icon 子分岐A child branch
CodeLens - [ピア分岐からの変更] アイコンCodeLens - Change from peer branch icon ピア分岐A peer branch
CodeLens - [遠くの分岐からの変更] アイコンCodeLens - Change from branch further away icon 親、子、またはピアより遠い分岐A branch further away than a parent, child, or peer
CodeLens: [親からのマージ] アイコンCodeLens: Merge from parent icon 親分岐から子分岐へのマージA merge from the parent branch to a child branch
CodeLens: [子分岐からのマージ] アイコンCodeLens: Merge from child branch icon 子分岐から親分岐へのマージA merge from a child branch to the parent branch
CodeLens: [関連付けられていない分岐からのマージ] アイコンCodeLens: Merge from unrelated branch icon 無関係の分岐からのマージ (ベースレス マージ)A merge from an unrelated branch (baseless merge)

リンクされた作業項目の検索Find linked work items

CodeLens - 特定のコードの作業項目を検出するCodeLens - Find work items for specific code

リンクされたコード レビューの検索Find linked code reviews

CodeLens - コード レビュー要求を表示するCodeLens - View code review requests

リンクされたバグの検索Find linked bugs

CodeLens - 変更セットにリンクされたバグを検出するCodeLens - Find bugs linked to changesets

項目の所有者に連絡するContact the owner of an item

項目の所有者に連絡するContact the owner of an item

連絡先のオプションを表示する項目のショートカット メニューを開きます。Open the shortcut menu for an item to see the contact options. Lync または Skype for Business がインストールされている場合は、次のオプションが表示されます。If you have Lync or Skype for Business installed, you see these options:

項目の連絡先オプションContact options for an item

コードの単体テストの検索 Find unit tests for your code

テスト エクスプ ローラーを開くことなく、ご使用のコード向けに存在する単体テストの詳細を確認します。Find out more about unit tests that exist for your code without opening Test Explorer. 要件:You'll need:

  • Visual Studio Enterprise または Visual Studio ProfessionalVisual Studio Enterprise or Visual Studio Professional

  • Visual C# .NET コードまたは Visual Basic .NET コードVisual C# .NET or Visual Basic .NET code

  • アプリケーション コードの単体テストを含む 単体テスト プロジェクトA unit test project that has unit tests for your application code

  1. 単体テストのあるアプリケーション コードに移動します。Go to application code that has unit tests.

  2. そのコードのテストをレビューします (Alt + 3)。Review the tests for that code (Alt + 3).

    CodeLens - コード エディターでテスト状態を選択するCodeLens - Choose test status in code editor

  3. CodeLens - 未実行の単体テストの警告 という警告アイコンが表示された場合、テストを実行します。If you see a warning icon CodeLens - Unit tests not yet run warning, run the tests.

    CodeLens - コード エディターでテスト状態を選択するCodeLens - View unit tests not run yet

  4. テストの定義を確認するには、CodeLens インジケーターのウィンドウでテスト項目をダブルクリックして、エディターでコード ファイルを開きます。To review a test's definition, double-click the test item in the CodeLens indicator window to open the code file in the editor.

    CodeLens - 単体テストの定義に移動するCodeLens - Go to unit test definition

  5. テストの結果を確認します。Review the test's results. テスト状態インジケーターを選択するか (CodeLens - 単体テスト失敗アイコン または CodeLens - 単体テスト成功アイコン)、Alt + 1 を押します。Choose the test status indicator (CodeLens - Unit test failed icon or CodeLens - Unit test passed icon), or press Alt + 1.

    CodeLens - 単体テストの結果を表示するCodeLens - See unit test result

  6. 何人のユーザーによってこのテストが変更されたか、だれがこのテストを変更したか、また、このテストに対していくつの変更が行われたかを確認するには、コードの履歴とリンクされた項目を検索します。To see how many people changed this test, who changed this test, or how many changes were made to this test, Find your code's history and linked items.

Q & A Q & A

Q: CodeLens を無効または有効にする方法を教えてください。 Q: How do I turn CodeLens off or on? 表示するインジケーターの選択方法も教えてください。Or choose which indicators to see?

A: 参照インジケーター以外のインジケーターは無効にも有効にもできます。A: You can turn indicators off or on, except for the references indicator. [ツール][オプション][テキスト エディター][すべての言語][CodeLens]の順に移動します。Go to Tools, Options, Text Editor, All Languages, CodeLens.

インジケーターが有効の場合は、インジケーターから CodeLens のオプションを開くこともできます。When the indicators are turned on, you can also open the CodeLens options from the indicators.

CodeLens - インジケーターを無効または有効にするCodeLens - Turn indicators off or on

エディター ウィンドウの下部にあるシェブロン アイコンを使用して、CodeLens のファイル レベル インジケーターのオンとオフを切り替えます。Turn CodeLens file-level indicators on and off using the chevron icons at the bottom of the editor window.

ファイル レベルのインジケーターのオンとオフを切り替えるTurn file-level indicators on and off

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

A: CodeLens は、メソッド、クラス、インデクサー、およびプロパティ レベルの Visual C# .NET および Visual Basic .NET のコードで表示されます。A: CodeLens appears in Visual C# .NET and Visual Basic .NET code at the method, class, indexer, and property level. それ以外の種類のファイルについては、ファイル レベルで CodeLens が表示されます。CodeLens appears at the file level for all other types of files.

  • CodeLens が有効になっていることを確認します。Make sure CodeLens is turned on. [ツール][オプション][テキスト エディター][すべての言語][CodeLens]の順に移動します。Go to Tools, Options, Text Editor, All Languages, CodeLens.

  • コードが TFS に格納されている場合は、 TFS Config コマンド と共に CodeIndex コマンドを使用することによって、コード インデックス作成が有効になっていることを確認します。If your code is stored in TFS, make sure that code indexing is turned on by using the CodeIndex command with the TFS Config command.

  • TFS 関連のインジケーターは、作業項目がコードにリンクされていて、リンクされた作業項目を開くアクセス許可をユーザーが持っている場合にだけ表示されます。TFS-related indicators appear only when work items are linked to the code and when you have permissions to open linked work items. チーム メンバーのアクセス許可があることを確認してください。Confirm that you have team member permissions.

  • アプリケーション コードに単体テストがない場合は、単体テスト インジケーターが表示されません。Unit test indicators don't appear when application code doesn't have unit tests. テスト状態インジケーターは、テスト プロジェクトに自動的に表示されます。Test status indicators appear automatically in test projects. アプリケーション コードに単体テストがあることがわかっているのに、テスト インジケーターが表示されない場合は、ソリューションのビルドを試みます (Ctrl + Shift + B)。If you know that your application code has unit tests, but the test indicators don't appear, try building the solution (Ctrl + Shift + B).

コミットの作業項目詳細が表示されないのはなぜですか。Q: Why don't I see the work item details for a commit?

A: CodeLens が TFS で作業項目を見つけることができない可能性があります。A: This might happen because CodeLens can't find the work items in TFS. その作業項目があるチーム プロジェクトに接続していることと、その作業項目を表示するアクセス許可があることを確認してください。Check that you're connected to the team project that has those work items and that you have permissions to see those work items. このことは、TFS での作業項目 ID に関する誤った情報がコミットの説明に含まれている場合にも発生することがあります。This might also happen if the commit description has incorrect information about the work item IDs in TFS.

Q: Lync インジケーターまたは Skype インジケーターが表示されないのはなぜですか。 Q: Why don't I see the Lync or Skype indicators?

A: Lync または Skype for Business にサインインしていない場合、Lync または Skype for Businessがインストールされていない場合、またはサポートされている構成がない場合、Lync インジケーターまたは Skype インジケーターは表示されません。A: They don't appear if you're not signed into Lync or Skype for Business, don't have one of these installed, or don't have a supported configuration. ただしその場合も、メールは送信できます。But you can still send mail:

CodeLens - 変更セット所有者にメールで連絡するCodeLens - Contact changeset owner by mail

サポートされる Lync 構成および Skype 構成Which Lync and Skype configurations are supported?

  • Skype for Business (32 ビットまたは 64 ビット)Skype for Business (32-bit or 64-bit)

  • Lync 2010 以降のみ (32 ビットまたは 64 ビット)。ただし Windows 8.1 での Lync Basic 2013 は除くLync 2010 or later alone (32-bit or 64-bit), but not Lync Basic 2013 with Windows 8.1

    CodeLens では、異なるバージョン の Lync または Skype はインストールできません。CodeLens doesn't support having different versions of Lync or Skype installed. Visual Studio のローカライズ バージョンに対して、Lync または Skype がローカライズされていないことがあります。They might not be localized for all localized versions of Visual Studio.

Q: CodeLens のフォントと色を変更するにはどうすればよいですか。Q: How do I change the font and color for CodeLens?

A: [ツール][オプション][環境][フォントおよび色]の順に選択します。A: Go to Tools, Options, Environment, Fonts and Colors.

CodeLens - フォントおよび色の設定の変更CodeLens - Change font and color settings

キーボードを使用するには:To use the keyboard:

  1. Alt + T + O キーを押して [オプション] ボックスを開きます。Press Alt + T + O to open the Options box.

  2. 上方向 キーまたは 下方向 キーを押して [環境] ノードに移動するか、 左方向 キーを押してノードを展開します。Press Up Arrow or Down Arrow to go to the Environment node, then press Left Arrow to expand the node.

  3. 下方向 キーを押して [フォントおよび色]に移動します。Press Down Arrow to go to Fonts and Colors.

  4. Tab キーを押して [設定の表示] の一覧に移動し、 下方向 キーを押して [CodeLens]を選択します。Press TAB to go to the Show settings for list, and then press Down Arrow to select CodeLens.

Q: CodeLens ヘッドアップ ディスプレイを移動できますか。Q: Can I move the CodeLens heads-up display?

A: はい。CodeLens - ウィンドウとしてドッキングする を選択し、CodeLens をウィンドウとしてドッキングします。A: Yes, choose CodeLens - Dock as a window to dock CodeLens as a window.

CodeLens インジケーター ウィンドウをドッキングするDock the CodeLens indicator window

ドッキングされた CodeLens 参照ウィンドウThe docked CodeLens References window

Q: インジケーターを更新するにはどうすればよいですか。Q: How do I refresh the indicators?

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

  • 参照: このインジケーターは、コードが変更されるときに自動的に更新されます。References: This indicator updates automatically when the code changes. インジケーターが独立したウィンドウとしてドッキングされている場合は手動で更新する必要があります。If you have this indicator docked as a separate window, refresh the indicator manually here:

    CodeLens - ウィンドウとしてドッキングするCodeLens - Dock as window

  • チーム: これらのインジケーターは手動で更新する必要があります。Team: Refresh these indicators manually here:

    CodeLens - インジケーターを更新するCodeLens - Refresh indicators

  • テスト: コードの単体テストを検索し、このインジケーターを更新します。Test: Find unit tests for your code to refresh this indicator.

Q: "ローカル バージョン" とは何ですか。 Q: What's "Local Version"?

A: [ローカル バージョン] 矢印は、このファイルのローカル バージョンの最新の変更セットを指しています。A: The Local Version arrow points at the most recent changeset in your local version of this file. サーバーにさらに新しい変更セットが含まれる場合、その変更セットは、使用されている並べ替え順序に応じて [ローカル バージョン] 矢印の上または下に表示されます。When the server has more recent changesets, they appear above or below the Local Version arrow, depending on the order used to sort the changesets.

Q: 履歴やリンク された項目が表示されるように CodeLens によるコードの処理方法を管理することはできますか。Q: Can I manage how CodeLens processes code to show history and linked items?

A: はい、できます。コードが TFS にある場合は、 TFS Config コマンド と共に CodeIndex コマンドを使用します。A: Yes, if your code is in TFS, use the CodeIndex command with the TFS Config command.