Visual Studio でのメモリ使用量の測定 (C#、Visual Basic、C++、F#)

[アーティクル]
02/28/2025

デバッガー統合 メモリ使用量 診断ツールを使用してデバッグしているときに、メモリリークと非効率的なメモリを見つけます。メモリ使用量ツールを使用すると、マネージドメモリヒープとネイティブメモリヒープ 1 つ以上の スナップショットを取得して、オブジェクトの種類のメモリ使用量への影響を把握できます。デバッガーをアタッチせずに、または実行中のアプリをターゲットにして、メモリ使用量を分析することもできます。詳細については、「リリースビルドまたはデバッグビルドでプロファイリングツールを実行する」を参照してください。ニーズに最適なメモリ分析ツールの選択については、「メモリ分析ツールを選択する」を参照してください。

メモリ使用量 ツールでは、いつでもメモリスナップショットを収集できますが、Visual Studio デバッガーを使用して、パフォーマンスの問題を調査しながらアプリケーションがどのように実行されるかを制御できます。ブレークポイント、ステップ実行、すべて中断、およびその他のデバッガーアクションを設定すると、最も関連性の高いコードパスにパフォーマンス調査を集中するのに役立ちます。アプリの実行中にこれらのアクションを実行すると、関心のないコードからのノイズを排除でき、問題の診断にかかる時間を大幅に短縮できます。

重要

デバッガー統合診断ツールは、ASP.NET、ASP.NET Core、ネイティブ/C++ 開発、混合モード (.NET およびネイティブ) アプリなど、Visual Studio での .NET 開発でサポートされています。

このチュートリアルでは、次の操作を行います。

メモリのスナップショットを取得する
メモリ使用量データの分析

メモリ使用量 が必要なデータを提供しない場合は、パフォーマンスプロファイラーの他のプロファイリングツール、役に立つ可能性のあるさまざまな種類の情報を提供します。多くの場合、アプリケーションのパフォーマンスのボトルネックは、CPU、レンダリング UI、ネットワーク要求時間など、メモリ以外のものによって発生する可能性があります。

手記

カスタムアロケーターサポート ネイティブメモリプロファイラーは、実行時に生成された ETW イベントデータ割り当てを収集することによって機能します。 CRT および Windows SDK のアロケーターには、割り当てデータをキャプチャできるようにソースレベルで注釈が付けられます。独自のアロケーターを記述する場合、新しく割り当てられたヒープメモリへのポインターを返す関数は、myMalloc の次の例に示すように、__declspec(アロケーター) で修飾できます。

__declspec(allocator) void* myMalloc(size_t size)

メモリ使用量データを収集する

Visual Studio でデバッグするプロジェクトを開き、メモリ使用量の調査を開始する時点でアプリにブレークポイントを設定します。

メモリの問題が疑われる領域がある場合は、メモリの問題が発生する前に最初のブレークポイントを設定します。

ヒント

アプリが頻繁にメモリを割り当て、割り当てを解除するときに関心のある操作のメモリプロファイルをキャプチャするのは困難な場合があるため、操作の開始時と終了時にブレークポイントを設定して (または操作をステップ実行して)、メモリが変更された正確なポイントを見つけます。
分析するコードの関数または領域の末尾に 2 つ目のブレークポイントを設定します (または、メモリの問題が発生した可能性が発生した後)。
診断ツールの ウィンドウは、オフにしていない限り自動的に表示されます。ウィンドウを再び表示するには、デバッグ>ウィンドウ>診断ツールを表示をクリックします。
ツールバーにある [ツールの選択] の設定で、[メモリ使用量] を選択します。
[デバッグ] / [デバッグの開始] をクリックします (またはツールバーで [スタート] をクリックするか、F5を押します)。

アプリの読み込みが完了すると、診断ツールの概要ビューが表示されます。

[診断ツールの概要] タブの

手記

メモリデータの収集はネイティブアプリまたは混合モードアプリのデバッグパフォーマンスに影響を与える可能性があるため、メモリスナップショットは既定で無効になっています。ネイティブまたは混合モードのアプリでスナップショットを有効にするには、デバッグセッションを開始します (ショートカットキー: F5)。 [診断ツール] ウィンドウが表示されたら、[メモリ使用量] タブを選択し、[ヒーププロファイリング] を選択します。

停止 (ショートカットキー: Shift+F5) してデバッグを再開します。

[診断ツールの概要] タブの

手記

メモリデータの収集はネイティブアプリまたは混合モードアプリのデバッグパフォーマンスに影響を与える可能性があるため、メモリスナップショットは既定で無効になっています。ネイティブまたは混合モードのアプリでスナップショットを有効にするには、デバッグセッションを開始します (ショートカットキー: F5)。 [診断ツール] ウィンドウが表示されたら、[メモリ使用量] タブを選択し、[ヒーププロファイリング] を選択します。

停止 (ショートカットキー: Shift+F5) してデバッグを再開します。
デバッグセッションの開始時にスナップショットを取得するには、[メモリ使用量] 概要ツールバーの [スナップショットの作成] 選択します。 (ここにブレークポイントを設定するのにも役立つ場合があります)。

アドバイス

メモリ比較のベースラインを作成するには、デバッグセッションの開始時にスナップショットを作成することを検討してください。
最初のブレークポイントにヒットするシナリオを実行します。
デバッガーが最初のブレークポイントで一時停止している間に、[スナップショットの作成] をメモリ使用量 の概要ツールバーで選択します。
F5 押して、2 番目のブレークポイントにアプリを実行します。
次に、別のスナップショットを作成します。

この時点で、データの分析を開始できます。

データの収集または表示で問題が発生した場合は、「プロファイリングエラーのトラブルシューティングとの問題の修正」を参照してください。

メモリ使用量データの分析

メモリ使用量の概要テーブルの行には、デバッグセッション中に作成したスナップショットが一覧表示され、より詳細なビューへのリンクが表示されます。

メモリ使用量テーブルのスクリーンショット。

列の名前は、プロジェクトのプロパティで選択するデバッグモード (.NET、ネイティブ、または混合 (.NET とネイティブの両方) によって異なります。

Objects (Diff) (.NET) 列または Allocations (Diff) (C++) 列には、スナップショットの作成時に .NET またはネイティブメモリ内のオブジェクトの数が表示されます。
ヒープサイズ (差分) 列には、.NET ヒープとネイティブヒープ内のバイト数が表示されます

複数のスナップショットを作成した場合、概要テーブルのセルには、行スナップショットと前のスナップショットの間の値の変更が含まれます。

メモリ使用量を分析するには、メモリ使用量の詳細レポートを開くリンクのいずれかをクリックします。

現在のスナップショットと前のスナップショットの違いの詳細を表示するには、矢印の左側にある変更リンクを選択します ()。赤い矢印はメモリ使用量の増加を示し、緑色の矢印は減少を示します。

ヒント

メモリの問題をより迅速に特定できるように、差分レポートは、全体の数が最も多いオブジェクトの種類 (オブジェクト (Diff) 列の変更リンクをクリック) またはヒープサイズ全体の中で最も大きくなったオブジェクトの種類 ([ヒープサイズ (差分)] 列の変更リンク クリック) で並べ替えられます。

選択したスナップショットのみの詳細を表示するには、変更されていないリンクをクリックします。

レポートは別のウィンドウに表示されます。

マネージド型のレポート

メモリ使用量の概要テーブルで、オブジェクト (Diff) セルの現在のリンクを選択します。

のスクリーンショット

手記

.NET コードの場合、ビューインスタンス アイコン (のインスタンスアイコン) は、デバッガー統合メモリ使用量ツールを使用しているとき、またはヒープスナップショットを開いて [マネージドメモリのデバッグ] 選択した場合にのみ使用できます。

上部のウィンドウには、スナップショット内の型の数とサイズ (型によって参照されるすべてのオブジェクトのサイズを含む) が表示されます (包括サイズ)。

下のウィンドウの [ルートのパス] ツリーには、上のウィンドウで選択されている型を参照するオブジェクトが表示されます。 .NET ガベージコレクターは、オブジェクトを参照する最後の型が解放された場合にのみ、オブジェクトのメモリをクリーンアップします。ルート ツリーへの パスの使用の詳細については、「ルートへのホットパスの分析」を参照してください。

マネージドタイプレポートのスクリーンショット。

下のウィンドウの [ルートのパス] ツリーには、上のウィンドウで選択されている型を参照するオブジェクトが表示されます。 .NET ガベージコレクターは、オブジェクトを参照する最後の型が解放された場合にのみ、オブジェクトのメモリをクリーンアップします。

参照型 ツリーには、上部ペインで選択した型によって保持されている参照が表示されます。

参照先オブジェクトレポートのスクリーンショット。

参照型 ツリーには、上部ペインで選択した型によって保持されている参照が表示されます。

参照先オブジェクトレポートのスクリーンショット。

選択した型のインスタンスを上のウィンドウに表示するには、オブジェクトの種類の横にある [インスタンスの表示] アイコン クリックします。

のインスタンスビュー

インスタンス ビューには、選択したオブジェクトのインスタンスが上のウィンドウのスナップショットに表示されます。 [ルートへのパス] ウィンドウと [参照先オブジェクトの ] ペインには、選択したインスタンスを参照するオブジェクトと、選択したインスタンスが参照する型が表示されます。スナップショットが作成された時点でデバッガーが停止すると、[値] セルにマウスポインターを合わせると、ツールヒントにオブジェクトの値が表示されます。

メモリ使用量ツールの [インスタンス] ビューのスクリーンショット。

ネイティブ型のレポート

[診断ツール] ウィンドウの [メモリ使用量の概要] テーブルで、割り当て (Diff) または ヒープサイズ (差分) セルの現在のリンクを選択します。

タイプビュー には、スナップショット内の型の数とサイズが表示されます。

選択した種類の横にある [インスタンスの表示] アイコンを選択すると、スナップショット内の選択した種類のオブジェクトに関する情報が表示されます。

インスタンス ビューには、選択した種類の各インスタンスが表示されます。インスタンスを選択すると、割り当て呼び出し履歴 ペインにインスタンスが作成された呼び出し履歴が表示されます。 (この情報は、デバッグ中にのみ使用できます)。

スナップショットで選択した種類のオブジェクトに関する情報を表示するには、選択した種類のインスタンスアイコン (のインスタンスアイコン) を選択します。

インスタンス ビューには、選択した種類の各インスタンスが表示されます。インスタンスを選択すると、割り当て呼び出し履歴 ペインにインスタンスが作成された呼び出し履歴が表示されます。

[スタック] を選択すると、選択した種類の割り当てスタックが表示されます。

[表示モード] リストで [スタックビュー] を選択すると、選択した種類の割り当てスタックが表示されます。

メモリ使用量の分析情報

マネージドメモリの場合、メモリ分析ツールでは、複数の強力な組み込みの自動分析情報も提供されます。 [マネージド型] レポートで [Insights] タブを選択すると、重複する文字列、スパース配列、イベントハンドラーリークなどの適用可能な自動分析情報が表示されます。

重複文字列 セクションには、ヒープに複数回割り当てられる文字列の一覧が表示されます。さらに、このセクションでは、無駄なメモリの合計(インスタンスの数 - 1)が文字列のサイズの倍であることを示します。

スパース配列の セクションには、ほとんどの要素がゼロで満たされている配列が表示されます。これは、パフォーマンスとメモリ使用量の面では非効率的な可能性があります。メモリ分析ツールは、これらの配列を自動的に検出し、これらのゼロ値のために無駄になっているメモリの量を示します。

Visual Studio 2022 バージョン 17.9 Preview 1 で使用可能な イベントハンドラーリーク セクションには、あるオブジェクトが別のオブジェクトのイベントをサブスクライブするときに発生する可能性があるメモリリークが表示されます。イベントのパブリッシャーがサブスクライバーの存続期間を超えた場合、たとえサブスクライバーへの他の参照がなくても、サブスクライバーは生存し続けます。これにより、メモリリークが発生し、未使用のメモリが適切に解放されず、時間の経過と同時にアプリケーションで使用されるメモリが増える可能性があります。

特定の型には、保持しているネイティブメモリのサイズを決定するために読み取ることができるフィールドが存在することがわかっています。 [Insights] タブには、オブジェクトグラフに偽のネイティブメモリノードが表示されます。これは、UI で認識され、サイズと参照グラフが表示されるように、親オブジェクトによって保持されます。