コードマップを使用して依存関係をマップする

この記事では、コードマップを使用してコード間の依存関係を視覚化する方法について説明します。

コードマップとは

Visual Studio では、コードマップを使用すると、ファイルやコード行を読み取ることなく、プログラムコードがどのように組み合わされるかをより迅速に確認できます。これらのマップを使用すると、構造とその依存関係、更新方法、提案された変更のコストの見積もりなど、コード内の組織と関係を確認できます。

コードの依存関係は、次の言語でマップできます。

ソリューションまたはアセンブリ内の Visual C# または Visual Basic (.dll または .exe)
Visual C++ プロジェクト、ヘッダーファイル (.h または #include)、バイナリでのネイティブまたはマネージド C++ コード
Microsoft Dynamics AX 用の .NET モジュールから作成された X++ プロジェクトとアセンブリ

Note

C# または Visual Basic 以外のプロジェクトでは、コードマップを開始したり、既存のコードマップに項目を追加したりするためのオプションが少なくなります。たとえば、C++ プロジェクトのテキストエディターでオブジェクトを右クリックしてコードマップに追加することはできません。ただし、 ソリューションエクスプローラー、 クラスビュー、 オブジェクトブラウザーから個々のコード要素またはファイルをドラッグアンドドロップできます。

前提条件

Visual Studio でコードマップを作成するには、最初にコードマップと Live Dependency Validation コンポーネントをインストールします

コードマップを作成および編集するには、 Visual Studio Enterprise エディションが必要です。ただし、Visual Studio Community および Professional エディションでは、Enterprise Edition で生成されたダイアグラムを開くことができますが、編集することはできません。

Note

Visual Studio Enterprise で作成されたマップを Visual Studio Professional を使用する他のユーザーと共有する前に、マップ上のすべての項目 (非表示アイテム、展開されたグループ、グループ間リンクなど) が表示されていることを確認してください。

コードマップを追加する

空のコードマップを作成し、アセンブリ参照、ファイル、フォルダーなどの項目をドラッグしたり、ソリューションのすべてまたは一部のコードマップを生成したりできます。

空のコードマップを追加するには:

ソリューションエクスプローラーで、最上位レベルのソリューションノードのショートカットメニューを開きます。 [ 追加>新しいアイテム] を選択します。
[ 新しい項目の追加 ] ダイアログの [ インストール済み] で、[ 全般 ] カテゴリを選択します。
Directed Graph Document(.dgml) テンプレートを選択し、[追加] を選択します。

ヒント

このテンプレートはアルファベット順に表示されない可能性があるため、表示されない場合は、テンプレート一覧の一番下まで下にスクロールします。

ソリューションの ソリューション項目 フォルダーに空のマップが表示されます。

同様に、ソリューションに追加せずに新しいコードマップファイルを作成するには、 アーキテクチャ>新しいコードマップ または ファイル>New>File を選択します。

詳細情報：

ソリューションのコードマップを生成する

ソリューション内のすべての依存関係を表示するには:

メニューバーで、[アーキテクチャ] >[ソリューションのコードマップの生成] を選択します。前回ビルドしてからコードが変更されていない場合は、代わりに [アーキテクチャ] を選択できます>ビルドせずにソリューションのコードマップを生成します。

最上位レベルのアセンブリとそれらの間の集約されたリンクを示すマップが生成されます。集計リンクが広いほど、それが表す依存関係が多くなります。
コードマップツールバーの [凡例 ] ボタンを使用して、プロジェクトの種類アイコン (テスト、Web、電話プロジェクトなど)、コード項目 (クラス、メソッド、プロパティなど)、および関係の種類 (継承、実装、呼び出しなど) の一覧を表示または非表示にします。

このソリューション例には、ソリューションフォルダー (テスト と コンポーネント)、テストプロジェクト、Web プロジェクト、アセンブリが含まれています。既定では、すべての包含リレーションシップが グループとして表示され、展開したり折りたたんだりできます。 Externals グループには、プラットフォームの依存関係など、ソリューションの外部に含まれるものがあります。外部アセンブリには、使用されている項目のみが表示されます。既定では、システムベースタイプは、マップ上の煩雑さを軽減するために非表示になっています。
マップをドリルダウンするには、プロジェクトとアセンブリを表すグループを展開します。 Ctrl キーを押しながら A キーを押してすべてのノードを選択し、ショートカットメニューから [グループ]、[展開] の順に選択すると、すべてを展開できます。
ただし、これは大規模なソリューションでは役に立たない場合があります。実際、複雑なソリューションの場合、メモリの制限により、すべてのグループを拡張できなくなる可能性があります。代わりに、個々のノード内を表示するには、ノードを展開します。ノードの上にマウスポインターを移動し、シェブロン (下矢印) が表示されたらクリックします。

または、項目を選択し、プラスキー (+) を押してキーボードを使用します。より深いレベルのコードを調べるには、名前空間、型、およびメンバーに対して同じ操作を行います。

ヒント

マウス、キーボード、タッチを使用したコードマップの操作の詳細については、「コードマップの参照と再配置」を参照してください。
マップを簡略化し、個々のパーツに集中するには、コードマップツールバーの [フィルター ] を選択し、目的のノードとリンクの種類のみを選択します。たとえば、すべてのソリューションフォルダーコンテナーとアセンブリコンテナーを非表示にすることができます。

また、基になるソリューションコードに影響を与えずに、個々のグループや項目を非表示にしたり、マップから項目を削除したりして、マップを簡略化することもできます。
項目間のリレーションシップを表示するには、マップ内でそれらを選択します。リンクの色は、[ 凡例 ] ウィンドウに示すようにリレーションシップの種類を示します。

この例では、紫色のリンクは呼び出し、点線のリンクは参照、水色のリンクはフィールドアクセスです。緑のリンクは継承にすることも、複数の種類のリレーションシップ (またはカテゴリ) を示す集約リンクである場合もあります。

ヒント

緑色のリンクが表示される場合は、継承関係しかないという意味ではない可能性があります。メソッド呼び出しもありますが、継承関係では非表示になります。特定の種類のリンクを表示するには、[ フィルター ] ウィンドウのチェックボックスを使用して、関心のない種類を非表示にします。
項目またはリンクに関する詳細情報を取得するには、ヒントが表示されるまでポインターをその上に移動します。これにより、コード要素またはリンクが表すカテゴリの詳細が表示されます。
集計リンクによって表される項目と依存関係を調べるには、まずリンクを選択し、そのショートカットメニューを開きます。 [ 共同投稿リンクの表示 ] を選択します (または 、新しいコードマップに投稿リンクを表示する) を選択します。これにより、リンクの両端にあるグループが展開され、リンクに参加している項目と依存関係のみが表示されます。
マップの特定の部分に焦点を当てるには、関心のない項目を引き続き削除できます。たとえば、クラスビューとメンバービューをドリルダウンするには、[フィルター] ウィンドウですべての名前空間ノードを フィルター 処理するだけです。
複雑なソリューションマップに注目するもう 1 つの方法は、既存のマップから選択した項目を含む新しいマップを生成することです。 Ctrl キーを押しながら、フォーカスする項目を選択し、ショートカットメニューを開き、[選択] から [新しいグラフ] を選択します。
含まれているコンテキストは、新しいマップに引き継がされます。 [ フィルター ] ウィンドウを使用して、ソリューションフォルダーやその他のコンテナーを非表示にします。
グループを展開し、マップ内の項目を選択してリレーションシップを表示します。

こちらもご覧ください。

依存関係の表示

保留中の変更がある一部のファイルでコードレビューを行うとします。これらの変更の依存関係を確認するには、それらのファイルからコードマップを作成します。

コードマップへの依存関係を示すスクリーンショット。

ソリューションエクスプローラー、クラスビュー、またはオブジェクトブラウザーから新規または既存のコードマップに項目をドラッグします。アイテムの親階層を含めるには、 Ctrl キーを 押しながら項目をドラッグするか、コードマップツールバーの [親を含める ] ボタンを使用して既定のアクションを指定します。 Windows エクスプローラーなど、Visual Studio の外部からアセンブリファイルをドラッグすることもできます。

Note

Windows Phone や Microsoft Store など、複数のアプリで共有されているプロジェクトからアイテムを追加すると、それらの項目は現在アクティブなアプリプロジェクトと共にマップ上に表示されます。コンテキストを別のアプリプロジェクトに変更し、共有プロジェクトからさらに項目を追加すると、それらの項目が新しくアクティブなアプリプロジェクトと共に表示されるようになります。マップ上のアイテムで実行する操作は、同じコンテキストを共有するアイテムにのみ適用されます。
マップには、含まれているアセンブリ内で選択した項目が表示されます。
項目を探索するには、項目を展開します。項目の上にマウスポインターを移動し、表示されたらシェブロン (下矢印) アイコンをクリックします。

すべての項目を展開するには、Ctrl+キーを使用して項目を選択し、マップのショートカットメニューを開き、[グループ>Expand] を選択します。ただし、すべてのグループを展開すると、使用できないマップまたはメモリの問題が発生する場合、このオプションは使用できません。
必要に応じて、関心のある項目をクラスやメンバーのレベルにまで引き続き展開してください。

コード内にあるがマップに表示されないメンバーを表示するには、グループの左上隅にある [子要素の再フェッチ] アイコンをクリックします。

マップ上の項目に関連するその他の項目を表示するには、1 つを選択し、コードマップツールバーの [関連 項目の表示] を選択してから、マップに追加する関連項目の種類を選択します。または、1 つ以上の項目を選択し、ショートカットメニューを開き、マップに追加する関連項目の種類の [表示 ] オプションを選択します。例えば次が挙げられます。

アセンブリの場合は、次を選択します。

Option	Description
この参照先のアセンブリを表示する	このアセンブリが参照するアセンブリを追加します。 [外部アセンブリ] グループに外部アセンブリが表示されます。
これを参照するアセンブリを表示する	このアセンブリを参照するアセンブリをソリューションに追加します。

名前空間の場合は、[含むアセンブリを表示] を選択します (表示されない場合)。

クラスまたはインターフェイスの場合は、次を選択します。

Option	Description
基本型の表示	クラスの場合は、基底クラスと実装されたインターフェイスを追加します。インターフェイスの場合は、基本インターフェイスを追加します。
派生型の表示	クラスの場合は、派生クラスを追加します。インターフェイスの場合は、派生インターフェイスと実装クラスまたは構造体を追加します。
この参照先の型を表示する	このクラスが使用するすべてのクラスとそのメンバーを追加します。
これを参照する型を表示する	このクラスを使用するすべてのクラスとそのメンバーを追加します。
含まれている名前空間を表示する	親名前空間を追加します。
含まれている名前空間とアセンブリを表示する	親コンテナー階層を追加します。
すべての基本型を表示する	基底クラスまたはインターフェイス階層を再帰的に追加します。
すべての派生型を表示する	クラスの場合は、すべての派生クラスを再帰的に追加します。インターフェイスの場合は、すべての派生インターフェイスを追加し、クラスまたは構造体を再帰的に実装します。

メソッドの場合は、次を選択します。

Option	Description
この呼び出しのメソッドを表示する	このメソッドが呼び出すメソッドを追加します。
この参照先のフィールドを表示する	このメソッドが参照するフィールドを追加します。
含まれている型を表示する	親型を追加します。
含まれている型、名前空間、およびアセンブリを表示する	親コンテナー階層を追加します。
オーバーライドされたメソッドの表示	他のメソッドをオーバーライドするメソッドまたはインターフェイスのメソッドを実装するメソッドの場合は、オーバーライドされる基底クラス内のすべての抽象メソッドまたは仮想メソッドを追加し、存在する場合は実装されるインターフェイスのメソッドを追加します。

フィールドまたはプロパティの場合は、次を選択します。

Option	Description
含まれている型を表示する	親型を追加します。
含まれている型、名前空間、およびアセンブリを表示する	親コンテナー階層を追加します。

メソッドを表示するためのコマンドを示すスクリーンショット。

マップにリレーションシップが表示されます。この例では、マップは、 Find メソッドによって呼び出されたメソッドと、ソリューションまたは外部での場所を示しています。
マップを簡略化し、個々のパーツに集中するには、コードマップツールバーの [フィルター ] を選択し、目的のノードとリンクの種類のみを選択します。たとえば、ソリューションフォルダー、アセンブリ、および名前空間の表示をオフにします。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-04-23

コード マップを使用して依存関係をマップする

コード マップとは

前提条件

コード マップを追加する

ソリューションのコード マップを生成する