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

CodeLens では、エディターを離れずにコードに関する情報を検索できるため、自分の作業に専念できます。CodeLens lets you stay focused on your work while you find out what happened to your code–without leaving the editor. コードの参照、コードへの変更、リンクされたバグ、作業項目、コード レビュー、単体テストを検索できます。You can find references to a piece of code, 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 インジケーター

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

CodeLens - チームに連絡する

表示するインジケーターを選択するか、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

C# コードまたは Visual Basic コードでの参照を検索することができます。You can find references in C# or Visual Basic code.

  1. 参照インジケーターを選択するか、Alt+2 キーを押します。Choose the references indicator, or press Alt+2.

    CodeLens 参照

    注意

    インジケータの表示に参照が 1 つもない場合は、C# コードまたは Visual Basic コードからの参照がないということです。If the indicator shows 0 references, you have no references from C# or Visual Basic code. ただし、.xaml ファイルや .aspx ファイルなどの他の項目に参照が含まれる場合があります。However, there may be references in other items such as .xaml and .aspx files.

  2. 参照元コードを表示するには、リスト内の参照の上にマウス ポインターを合わせます。To view the referencing code, mouse over the reference in the list.

    CodeLens - 参照を確認する

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

コード マップCode maps

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

CodeLens - コード マップ上の参照

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

コードの変遷をたどるため、コードの履歴を確認します。Inspect 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 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

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

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

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

.cs または .vb 以外のファイルの種類については、ウィンドウ下部の 1 個所でファイル全体の CodeLens の詳細を取得します (ファイル レベル のインジケーター)。For file types other than .cs or .vb, you get CodeLens details for the entire file in one place at the bottom of the window (file-level indicators).

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

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

コードの要素レベルのインジケーターでは、コードを変更したユーザー、およびそのユーザーが変更した内容を確認できます。Code element-level indicators let you see who changed your code, and what changes they made. コードの要素レベルのインジケーターは、C# および Visual Basic コードに対して利用できます。Code element-level indicators are available for C# and Visual Basic code.

これは、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 で自分のコードの変更履歴を取得する

既定の時間は直近 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 the time period 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:

すべてのコード変更を表示する

[履歴] ウィンドウが開きます。The History window opens:

すべてのコード変更の履歴ウィンドウ

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

CodeLens: Git で自分のコードの変更履歴を取得する

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

ウィンドウ下部のファイル レベルのインジケーターで、ファイル全体の変更を探します。Find changes for an entire file in the file-level indicators at the bottom of the window:

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

注意

ファイル レベルのインジケーターは、C# ファイルおよび Visual Basic ファイルでは利用できません。File-level indicators are not available for C# and Visual Basic files.

変更に関する詳細情報を取得するには、その項目を右クリックします。To get more details about a change, right-click that item. TFVC を使用しているか Git を使用しているかに応じて、ファイルのバージョンの比較、詳細の表示と変更セットの追跡、ファイルの選択バージョンの取得、その変更の作成者への電子メール通知のためのオプションがあります。Depending on whether you are using TFVC or Git, there are 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: コードの変更履歴をグラフで表示

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

安定したコードの状態を損なわせるリスクを軽減するために、チームは複数の分岐 (メイン分岐とその下位の開発分岐など) で作業する場合があります。Your team may have multiple branches, for example a main branch and a child development branch, to reduce the risk of breaking stable code.

CodeLens: コードが分岐された時間を検索

メイン分岐で、コードを変更したユーザーの数と、変更の数を確認できます。それには、Alt + 6キーを押します。You can find out how many people changed your code and how many changes were made in the main branch by pressing Alt+6:

CodeLens: この分岐での変更数を検索

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

コードが分岐された時期を確認するには、子分岐のコードに移動します。To find when your code was branched, navigate to your code in the child branch. 次に、変更インジケーターを選択するか、Alt + 6 キーを押します。Then, select the changes indicator or pressAlt+6:

CodeLens: コードが分岐された時間を検索

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

CodeLens: 別の分岐でのコード変更を検索

追加された変更を表示することができます。You can view incoming changes. 次のスクリーン ショットでは、"Dev" 分岐で、バグ修正が行われています。In the following screenshot, a bug fix was made in the "Dev" branch:

CodeLens: 別の分岐にチェックインされた変更

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

CodeLens: 別の分岐からの変更を表示

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

変更がマージされた時期を確認できます。したがって、分岐にどの変更が含まれているかを特定できます。You can see when changes got merged, so you can determine which changes are included in your branch:

CodeLens - 分岐間でマージされた変更

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

CodeLens - 分岐間でマージされた変更

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

追加される変更をローカル バージョンと比較するには、Shift + F10 キーを押すか、または変更セットをダブルクリックします。Compare an incoming change with your local version by pressing Shift+F10, or by double-clicking the changeset.

CodeLens: 受信した変更をローカルと比較

分岐アイコンBranch icons

[分岐] 列のアイコンは、分岐が、作業中の分岐とどのような関係にあるのかを示します。The icon in the Branch column tells you how the branch is related to the branch you're working in.

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

リンクされた作業項目Linked work items

リンクされた作業項目を検出するには、作業項目インジケーターを選択するか、または Alt + 8 キーを押します。Find linked work items by selecting the work items indicator or by pressing Alt+8.

CodeLens - 特定のコードの作業項目を検出する

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

リンクされたコード レビューを検出するには、レビュー インジケーターを選択します。Find linked code reviews by selecting the reviews indicator. キーボードを使用する場合は、Alt キーを押しながら左方向キーまたは右方向キーを押して、インジケーター オプション間を移動します。To use the keyboard, hold down the Alt key and then press Left arrow or Right arrow to navigate the indicator options.

CodeLens - コード レビュー要求を表示する

リンクされているバグLinked bugs

リンクされているバグを検出するには、バグ インジケーターを選択するか、または Alt + 7 キーを押します。Find linked bugs by selecting the bugs indicator or by pressing Alt+7.

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

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

項目の所有者を確認するには、所有者インジケーターを選択するか、または Alt + 5 キーを押します。Find the author of an item by selecting the authors indicator or by pressing Alt+5.

項目の所有者に連絡する

連絡先のオプションを表示する項目のショートカット メニューを開きます。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:

項目の連絡先オプション

関連付けられた単体テストAssociated unit tests

テスト エクスプローラーを開くことなく、ご使用の C# コードまたは Visual Basic コード向けに存在する単体テストを検出することができます。You can discover unit tests that exist for your C# or Visual Basic code without opening Test Explorer.

  1. 単体テスト コードに関連付けられたアプリケーション コードに移動します。Go to application code that has associated unit test code.

  2. CodeLens テスト インジケーターを読み込むためにアプリケーションをまだビルドしていない場合は、ビルドします。If you have not already, build your application to load the CodeLens test indicators. ビルド済みアセンブリでの検出がオンになっていることを確認します。Make sure discovery by built assemblies is turned on.

  3. コード用のテストをレビューするには、Alt + 3 キーを押します。Review the tests for the code by pressing Alt+3.

    CodeLens - コード エディターでテスト状態を選択する

  4. 警告アイコンIf you see a warning icon 警告アイコンが表示された場合、まだ実行されていないので、テストを実行します。, the tests haven't run yet, so run them.

    CodeLens - 未実行の単体テストを表示する

  5. テストの定義を確認するには、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 - 単体テストの定義に移動する

  6. テスト結果を確認するには、テスト状態インジケーター (テスト失敗アイコンまたはテスト成功アイコン) を選択するか、Alt + 1 キーを押します。To review the test's results, choose the test status indicator (test failed icon or test passed icon), or press Alt+1.

    CodeLens - 単体テストの結果を表示する

  7. 何人のユーザーによってこのテストが変更されたか、だれがこのテストを変更したか、また、このテストに対していくつの変更が行われたかを確認するには、コードの履歴とリンクされた項目を検索します。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.

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

キーボードを使用してインジケーターを選択するには、Alt キーを押したままにして関連する数字キーを表示し、目的のインジケーターに対応する数字キーを押します。To use the keyboard to select indicators, press and hold the Alt key to display the related number keys, then press the number that corresponds to the indicator you want to select.

キーボード アクセス番号

注意

レビュー インジケーターを選択するには、Alt キーを押しながら、左方向キーと右方向キーを使用して移動します。To select the reviews indicator, hold down Alt while using the left and right arrow keys to navigate.

Q & AQ & 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 CodeLens file-level indicators on and off using the chevron icons at the bottom of the editor window.

ファイル レベルのインジケーターのオンとオフを切り替える

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

A: CodeLens は、メソッド、クラス、インデクサー、およびプロパティ レベルの C# および Visual Basic のコードで表示されます。A: CodeLens appears in C# and Visual Basic 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 に関する誤った情報がコミットの説明に含まれている場合、作業項目の詳細が表示されないこともあります。Work item details might not also not show if the commit description has incorrect information about the work item IDs in TFS.

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

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

CodeLens - 変更セット所有者にメールで連絡する

サポートされる Skype および Lync 構成Which Skype and Lync 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 - フォントおよび色の設定の変更

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

  1. Alt + T + O キーを押して、[オプション] ダイアログ ボックスを開きます。Press Alt+T+O to open the Options dialog 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: はい、できます。[Dock] アイコンを選択して、CodeLens をウィンドウとしてドッキングします。A: Yes, choose Dock icon to dock CodeLens as a window.

CodeLens インジケーター ウィンドウの [Dock] ボタン

ドッキングされた CodeLens 参照ウィンドウ

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 the References indicator is docked as a separate window, refresh the indicator by selecting Refresh:

    CodeLens 参照の [更新] ボタン

  • チーム: これらのインジケーターを更新するには、右クリック メニューから [CodeLens チームのインジケーターの更新] を選択します。Team: Refresh these indicators by selecting Refresh CodeLens Team Indicators from the right-click menu:

    [CodeLens チームのインジケーターの更新] メニュー項目

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

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

A: [ローカル バージョン] 矢印は、ファイルのローカル バージョンの最新の変更セットを指しています。A: The Local Version arrow points at the most recent changeset in your local version of a 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: できます。A: Yes. コードが TFS にある場合は、TFS Config コマンド と共に CodeIndex コマンドを使用します。If your code is in TFS, use the CodeIndex command with the TFS Config command.

Q: ソリューションを最初に開いたときに、ファイルに CodeLens テスト インジケーターが表示されなくなります。Q: My CodeLens test indicators no longer appear in my file when I first open my solution. これを読み込むにはどうすればよいですか。How can I load them?

A: プロジェクトをリビルドし、ファイルに読み込む CodeLens テスト インジケーターを取得します。A: Rebuild your project to get CodeLens test indicators to load in your file. ビルド済みアセンブリでの検出がオンになっていることを確認します。Make sure discovery by built assemblies is turned on. パフォーマンスを向上させるため、Visual Studio では、コード ファイルが読み込まれるときにテスト インジケーターのソース情報がフェッチされなくなります。To improve performance, Visual Studio no longer fetches source information for test indicators when code files are loaded. テスト インジケーターは、ビルド後、またはテスト エクスプローラーでダブルクリックしてテストに移動するときに読み込まれます。Test indicators are loaded after a build, or when you navigate to a test by double-clicking on it in Test Explorer.

関連項目See also