コードエディターでデータヒントを使用して変数値を表示および変更する

[アーティクル]
04/03/2025

この記事では、Visual Studio でデータヒント機能を使用する方法について説明します。データヒントは、コードのデバッグ中にプログラム内の変数に関する情報を表示する便利な方法を提供します。コードにブレークポイントを設定してデバッグを開始すると、変数が現在の実行スコープに入ると、データヒントが表示されます。データヒントを使用してスコープ内の変数の値を変更し、ブレークポイントでコードを再実行して変更の影響を確認できます。

ヒント

デバッグを初めて使用する場合は、この記事を進める前に、初心者向けのデバッグとデバッグの手法とツールを読んでください。

前提条件

Visual Studio。 Visual Studio をお持ちでない場合は、Visual Studio のダウンロードページに移動して無料でインストールしてください。
Visual Studio デバッガーで実行するプログラムコード。

データヒントを操作する

コードにブレークポイントを設定すると、デバッグセッション中にデータヒントが表示されます。デバッガーがブレークポイントでプログラムの実行を一時停止すると、現在のスコープ内のすべての変数に対してデータヒントを使用できます。

Visual Studio 2022 バージョン 17.14 以降では、LINQ 式のデータヒントを表示することもできます。

その手順は次のとおりです。

コードにブレークポイントを設定し、[デバッグ] を選択してデバッグを開始します>デバッグを開始するか、F5 キーボードショートカットを使用します。
デバッガーがブレークポイントで実行を一時停止したら、現在のスコープ内の任意の変数にカーソルを合わせて、データチップを開きます。
データヒントを使用して変数の名前を確認し、値を操作します。
必要に応じて、変数の値を変更するか、コメントを追加します。

注

Visual Studio は、実行中にデバッガーが一時停止されているコンテキストに基づいて、データヒント内の変数の値を評価して表示します。評価は、カーソルまたはデータヒントの現在の位置に基づいていません。現在のコンテキストの変数と同じ名前を持つ別の関数の変数にカーソルを合わせると、現在のコンテキストのデータヒントに変数の値が表示されます。

Visual Studio では、次のような、データヒントと変数と値の操作に関する多くのアクションがサポートされています。

コードの実行が続く間、データヒントをピン留めまたはフローティングして表示し続ける
データヒントを透明にする
他の場所を選択するまで展開したままの "固定" データヒントを有効にする
配列、構造体、またはオブジェクトのデータヒントを展開して、そのメンバーをツリー形式で表示します。
データヒントの変数の値を変更する
デバッグ中にメモを取るためにピン留めされたデータヒントに複数行のコメントを追加する
データのインポートとエクスポートのヒント

データヒントを透明にする

変数の上にカーソルを合わせてデータヒントを表示すると、データヒントを透明にして下のコードを表示できます。このアクションにより、メソッド定義や式構文など、コードエディター内の他のヒントアクションの透過性もオンになります。

透明度を有効にするには、次の手順に従います。

Visual Studio Code エディターで、データヒント内を選択し、Ctrl キーを押しながら選択します。
透明度を維持するには、Ctrl キーを押しながら続行します。
透明度を終了するには、Ctrl キーの選択を停止するか、別の場所を選択します。

ピン留めされたまたはフローティングのデータヒントに対して、透明度は使用できません。

データヒントを展開されたままにする

Visual Studio 2022 Update 1 以降では、データヒントを展開するときに、他の場所を選択するまで展開したままにしておくことができます。このアクションにより、固定データチップが生成されます。

データヒントを固定するには、次の手順に従います。

Visual Studio で[デバッグ]>[オプション]を選択して[オプション]ダイアログを開きます。
[全般] タブ内でスクロールして、[クリックされるまで、展開されたデータヒントを開いたままにする] オプションを見つけます。
チェックボックスをオンにして固定オプションを有効にし、[ OK] を選択します。

コードエディターでスティッキーオプションを有効にすると、データヒントを展開した場合、そのヒントは展開されたままになります。

データヒントをピン留めする

データヒントをピン留めして、コードエディター画面上で開いたままにすることができます。ピン留めされたデータヒントの場所を変更することもできます。

データヒントをピン留めするには、次の手順に従います。

Visual Studio Code エディターで、変数の上にマウスポインターを置くと、データヒントが表示されます。
データヒント内で、画鋲を使用して [ソースにピン設定] を選択します。

Visual Studio は、コードサーフェイス上の変数の近くの場所にデータヒントをピン留めします。データヒントをピン留めする行の横にある、コードエディターのとじしろの中に画鋲が表示されます。
ピン留めされたデータヒントを選択して、コードエディター画面の任意の場所にドラッグします。

データヒントをフローティングにする (ピン留めを外す)

データヒントをピン留めした後、データヒントのピン留めを外して浮動にすることができます。フローティングデータヒントは、Visual Studio IDE 内の任意の場所に配置できます。

データヒントをフローティングにするには、次の手順に従います。

ピン留めされているデータヒント内で、画鋲を使用して [ソースをピン解除] を選択します。

Visual Studio は、データヒントのピン留めを解除し、データヒントに単色の背景を表示します。データヒントのプッシュピンがピン留めされていない位置に変わり、コードエディターの余白のプッシュピンが削除されます。
フローティングデータヒントを選択して、Visual Studio IDE 内の任意の場所にドラッグします。

浮動データヒントをコードエディター画面の外側に配置すると、データヒントのサイドメニューからプッシュピンが削除されます。 [ソースにピン設定] オプションは、フローティングデータヒントがコードエディター画面上に配置されている場合にのみ使用可能です。

データヒントを再度ピン留めする

データヒントをフローティングにした後、コードエディター画面上の特定のソースの場所に再度ピン留めすることができます。

フローティングデータヒントを再度ピン留めするには、次の手順に従います。

フローティングデータヒントを選択して移動させ、コードエディター画面上に配置します。
フローティングデータヒント内で、画鋲を使用して [ソースにピン設定] を選択します。

プッシュピンがピン留めされた位置に変わります。データチップはコードエディター内の特定の場所に再固定され、ソースのプッシュピンがコードエディターのガターに表示されます。

データヒントを閉じる

Visual Studio でデータヒントを閉じる方法にはいくつかの選択肢があります。

デバッグセッションを終了すると、開いているデータヒントがある場合は、Visual Studio によってそれらのヒントが閉じられます。別のデバッグセッションを起動すると、Visual Studio は、以前に開いたままにしていたデータヒントの再確立を試みます。

次の表は、データヒントを手動で閉じる方法をまとめたものです。

ターゲットを閉じる	アクション
特定データのヒント	データヒント内で "X" を選択します。
特定のファイルに関するすべてのデータヒント	Visual Studio のツールバー上で [デバッグ]>[<ファイル名> にピン設定されたすべてのデータヒントをクリア] を選択します。
オープンデータに関するすべてのアドバイス	Visual Studio ツールバーの [デバッグ>すべてのデータヒントをクリアする] を選択します。

データヒントで変数と値を操作する

Visual Studio でデータヒントを操作すると、変数とオブジェクトに関する詳細を表示したり、デバッグ中に値を編集したりできます。これらの機能は、コードに対する変更の迅速なトラブルシューティングとテストに役立ちます。

データヒント内のオブジェクトを展開してメンバーを表示する

データヒントが配列、構造体、またはオブジェクトを表す場合は、データヒントビューを展開してメンバーを表示できます。展開されたビューには、階層ツリー形式で追加情報が表示されます。

データヒント内のオブジェクトのビューを展開するには、次の手順に従います。

配列、構造体、またはオブジェクトのデータヒントで、項目名の前にある展開矢印を選択してメンバーを表示します。ビューはツリー形式で表示されます。

ピン留めされたデータヒントの場合は、変数名の前にあるプラス記号 (+) を選択して定義を展開します。
引き続き展開矢印を選択して、メンバー階層の詳細を表示します。
展開ビューで上下に移動するには、マウスまたはキーボードの上下の方向キーを使用します。
元のピン留めされたデータヒントを使用して展開されたメンバーをピン留めするには、メンバー上の画鋲を使用して [ソースにピン設定] を選択します。ツリービューを折りたたんでも、ピン留めされたメンバー要素はピン留めされたデータヒントとともに表示されたままです。

変数の値を編集する

データヒントを操作するもう 1 つの利点は、デバッグ中にデータヒント内の変数または要素の値を編集できることです。この機能は、コードに対する小さな変更をすばやくテストする場合に便利です。

データヒントの変数または要素の値を編集するには、次の手順に従います。

データチップで値を選択します。 Visual Studio によって値が強調表示され、編集できるようになります。
データヒントに新しい値を入力し、Enter キーを押します。

一部の変数値は読み取り専用であることに注意してください。 Visual Studio では、読み取り専用の値を編集に使用することはできません。

データヒント内でコメントを使用する

データヒントの コメント 領域は、コードをデバッグするときに変数に関するメモを保持するのに役立ちます。このリージョンは、デバッグ中に変化するさまざまな値を追跡するのに便利な場所です。ピン留めされたまたはフローティングのデータヒント内にコメントを追加できます。

データヒントで コメント を使用するには、次の手順に従います。

データヒントで、下にダブル矢印を使い、[展開してコメントを表示]を選択します。二重下矢印を押すと、データヒントの コメント 領域が開き、そこでメモを追加できます。
コメントを追加するには、[コメント ] 領域に カーソルを挿入し、テキストを入力します。この領域は複数の行を受け入れます。
コメント領域を閉じるには、二重上矢印を使用してコメントを折りたたみます。入力したコメントはデータヒントに残りますが、現在は表示されません。

データヒント内のプロパティをピン留めする

Visual Studio では、.NET Core 3.0 以降において、ピン留めされたデータヒント内のプロパティのピン留めがサポートされています。この機能を使用すると、データヒントのプロパティによってオブジェクトをすばやく検査できます。

データヒント内のプロパティをピン留めするには、次の手順に従います。

ピン留めされたデータヒント内で、データヒントで表示したままにするプロパティが見えるまで、メンバーの階層を展開します。
プロパティの画鋲を使用して、データヒントにピン留めします。プロパティを右クリックして、[メンバーをお気に入りとしてピン留め] を選択することもできます。

Visual Studio は、選択したプロパティをオブジェクトのプロパティリストの先頭に移動します。ピン留めされたデータヒントの右側の列にプロパティ名と値が表示されます。
データヒントでプロパティのピン留めを解除するには、プロパティのプッシュピンをもう一度選択するか、プロパティを右クリックして [ メンバーをお気に入りに固定解除] を選択します。

また、プロパティ名の表示/非表示を切り替え、データヒントのオブジェクトのプロパティリストでピン留めされていないプロパティを除外することもできます。

ピン留めされていないプロパティを除外するには、データヒントでプロパティ行を右クリックし、[ 固定されたメンバーのみを表示] を選択します。
プロパティ名の表示を切り替えるには、データヒント内のプロパティ行を右クリックし、値内に固定されたメンバー名を非表示を選択します。

次の図は、データヒントのメンバー階層の右クリックメニューのさまざまなオプションを示しています。

AI のサポートを受ける

Copilot を使用している場合は、データヒントで変数を見ている間に AI の支援を受けることができます。変数を右クリックし、[Copilot に質問する] を使用します。このシナリオでは、Copilot は質問のコンテキストを既に認識しているため、チャットで自分でコンテキストを提供する必要はありません。詳細については、「Copilotを使用したデバッグ」を参照してください。

Visual Studio 2022 バージョン 17.14 以降では、LINQ 式のデータヒントから Copilot のサポートを受けることもできます。

複雑なデータ型を視覚化する

ビジュアライザーは、より意味のある、時にはグラフィカルな方法で情報を表示します。ビジュアライザーの例としては、XML、HTML、JSON、テキストビジュアライザー、表形式ビジュアライザーなどがあります。視覚化を使用して、デバッグ中にコード内の複雑なデータ型を調べることができます。

ビジュアライザーを要素に対して使用できる場合、Visual Studio では、データヒントの要素名の横に ビュー 虫眼鏡が表示されます。視覚化を選択すると、Visual Studio によって別のウィンドウが開き、複雑なデータが読み取り可能な形式で表示されます。

この機能を使用して、データの視覚化を選択できます。

データ型の既定のビジュアライザーを使用して要素を表示するには、虫眼鏡を選択します。
特定のビジュアライザーを選択するには、虫眼鏡の横にある [表示 ] ドロップダウンリストを展開し、オプションを選択します。

ウォッチウィンドウに変数を追加する

データヒントから Visual Studio ウォッチウィンドウに変数を追加することで、引き続き変数を監視できます。

データヒントで変数名を右クリックし、[ ウォッチの追加] を選択します。

Visual Studio は 、[ウォッチ ] ウィンドウに変数を追加します。 Visual Studio エディションで複数の ウォッチ ウィンドウがサポートされている場合、変数は Watch 1 というラベルのウィンドウに表示されます。

データのインポートとエクスポートのヒント

データヒントを XML ファイルにエクスポートできます。XML ファイルは、テキストエディターを使用して共有または編集できます。また、受信した XML ファイルまたは以前に編集した XML ファイルからデータヒントをインポートすることもできます。

データヒントをエクスポートするには、次の手順に従います。

Visual Studio で、[ デバッグ>Export DataTips] を選択します。 [ データヒントのエクスポート ] ダイアログが開きます。
ダイアログで、XML ファイルを保存する場所を参照します。
エクスポートファイルの名前を入力し、[ 保存] を選択します。

Visual Studio は、指定したファイルと場所にデータヒントをエクスポートします。

ファイルからデータヒントをインポートするには、次の手順に従います。

Visual Studio で、[デバッグ] > [データヒントのインポート] を選択します。 [ データヒントのインポート ] ダイアログが開きます。
ダイアログで、インポートに使用するデータヒント XML ファイルの場所を参照します。
開くファイルを選択し、[ 開く] を選択します。

Visual Studio は、指定したファイルから現在のワークスペースにデータヒントをインポートします。ワークスペースコードをデバッグすると、インポートされたデータヒントを使用できます。

次の方法で共有

コードエディターでデータヒントを使用して変数値を表示および変更する

前提条件