Просматривайте и изменяйте значения переменных с помощью всплывающих подсказок в редакторе кода.

Статья
2025-03-17

В этой статье описывается, как работать с функцией советов по данным в Visual Studio. Подсказки данных предоставляют удобный способ просмотра информации о переменных вашей программы при отладке кода. При установке точек останова в коде и запуске отладки подсказки отображаются для переменных по мере вхождения в текущую область выполнения. Подсказку к данным можно использовать для изменения значения переменной в области видимости и повторного запуска кода на точке останова, чтобы увидеть эффект изменения.

Совет

Если вы не знакомы с отладкой, вам может понадобиться прочитать Отладка для абсолютных новичков и Методы и инструменты отладки, прежде чем приступить к статье.

Необходимые условия

Visual Studio. Если у вас нет Visual Studio, перейдите на страницу загрузки Visual Studio, чтобы установить её бесплатно.
Некоторый код программы для запуска в отладчике Visual Studio.

Работа с подсказками по данным

Подсказки по данным отображаются во время сеанса отладки при наличии точек останова в коде. Когда отладчик приостанавливает выполнение программы в точке останова, подсказки доступны для любых переменных текущей области.

Начиная с версии 17.14 Visual Studio 2022, вы также можете просматривать подсказки данных для выражений LINQ.

Ниже приведен процесс.

Задайте точку останова в коде и начните отладку, выбрав Отладка>начать отладку или используйте сочетание клавиш F5.
Когда отладчик приостанавливает выполнение в точке останова, наведите указатель мыши на любую переменную в текущей области, чтобы открыть подсказку данных.
Используйте подсказку по данным, чтобы просмотреть имя переменной и работать со значением.
При необходимости измените значение переменной или добавьте комментарии.

Заметка

Visual Studio вычисляет и отображает значение переменной в подсказке данных в контексте, где отладчик приостановлен во время выполнения. Оценка не основана на текущем расположении курсора или подсказки данных. Если наведите указатель мыши на переменную в другой функции, которая имеет то же имя, что и переменная в текущем контексте, Visual Studio отображает значение переменной в подсказке данных для текущего контекста.

Visual Studio поддерживает множество действий для советов по данным и работы с переменными и значениями, в том числе:

Закрепите или оставьте плавающую подсказку данных, чтобы она оставалась видимой во время выполнения кода
Сделать подсказки прозрачными
Включите закреплённые подсказки по данным, которые остаются развернутыми, пока вы не сделаете другой выбор.
Разверните подсказку данных для массива, структуры или объекта, чтобы просмотреть его члены в виде дерева
Изменение значения переменной в подсказке данных
Добавление многострочных комментариев в прикрепленную подсказку данных для заметок во время отладки
Советы по импорту и экспорту данных

Сделать подсказки прозрачными

При наведении указателя мыши на переменную для просмотра всплывающей подсказки, можно сделать эту подсказку прозрачной, чтобы видеть код под ней. Это действие также включает прозрачный режим для других подсказок в редакторе кода, таких как определения методов и синтаксис выражений.

Чтобы включить прозрачность, выполните следующие действия.

В редакторе Visual Studio Code выберите информацию внутри подсказки данных, а затем нажмите и удерживайте клавишу Ctrl.
Чтобы обеспечить прозрачность, продолжайте удерживать ctrl.
Чтобы отключить прозрачность, перестаньте удерживать клавишу Ctrl или выберите что-то другое.

Прозрачность недоступна для закреплённой или всплывающей подсказки.

Держите советы по данным в развернутом виде

В Visual Studio 2022 с обновлением 1 и более поздних версий, когда вы разворачиваете подсказку данных, её можно оставить в развернутом виде, пока вы не выберете что-то другое. Это действие создает липкую подсказку данных.

Чтобы сделать подсказку с данными закрепленной, выполните следующие действия.

В Visual Studio выберите >Параметры отладки, чтобы открыть диалоговое окно "Параметры".
На вкладке "Общие" пролистайте вниз, чтобы найти параметр "Сохранить раскрытые подсказки по данным до щелчка".
Установите флажок, чтобы включить опцию фиксирования, а затем нажмите ОК.

Если в редакторе кода включен липкий параметр, любой развернутый информационный блок данных останется развернутым.

Закрепить подсказки по данным

Подсказку с данными можно закрепить, чтобы она оставалась открытой на поверхности окна редактора кода. Вы также можете изменить расположение закрепленной всплывающей подсказки.

Чтобы закрепить подсказку данных, выполните следующие действия.

В редакторе Visual Studio Code наведите указатель мыши на переменную, чтобы отобразить информационную подсказку.
В подсказке данных нажмите кнопку, чтобы выбрать Закрепить в источнике:

Visual Studio прикрепляет подсказку данных рядом с переменной на поверхности кода. В поле редактора кода рядом со строкой, в которой вы закрепляете подсказку данных, появится значок булавки.
Выберите и перетащите закреплённую подсказку с данными в любое место в редакторе кода.

Открепить (сделать плавающими) подсказки данных

После закрепления подсказки данных можно открепить подсказку данных и сделать ее перемещаемой. Плавающая подсказка данных может размещаться в любом месте интегрированной среды разработки Visual Studio.

Чтобы закрепить подсказку по данным, выполните следующие действия.

В закрепленной подсказке данных используйте значок кнопки, чтобы выбрать Открепить от источника.

Visual Studio открепляет подсказку данных и устанавливает для нее однотонный цвет фона. Значок канцелярской кнопки для подсказки данных изменяется на открытую позицию, и кнопка в полях редактора кода удаляется.
Перетащите всплывающую подсказку в любое место в среде разработки Visual Studio.

Если расположить всплывающую подсказку с данными за пределами области редактора кода, значок закрепления удаляется из бокового меню подсказки данных. Опция Закрепление к источнику доступна только тогда, когда плавающая подсказка находится на поверхности редактора кода.

Советы по повторной привязке данных

После размещения всплывающей подсказки данных его можно закрепить в определённом месте в редакторе кода.

Чтобы восстановить плавающую подсказку данных, выполните следующие действия.

Выберите и переместите всплывающую подсказку данных, а затем разместите ее на поверхности редактора кода.
В плавающем окне данных используйте кнопку, чтобы выбрать Закрепить для источника.

Значок закрепления изменяется в состояние закреплено. Подсказка по данным будет прикреплена к определенному месту в редакторе кода, а в его полях появится значок исходного кода.

Закройте советы по данным

В Visual Studio есть несколько способов закрыть советы по данным.

Когда вы завершаете сеанс отладки, если у вас есть открытые подсказки данных, Visual Studio закроет их за вас. Если вы запускаете другой сеанс отладки, Visual Studio пытается восстановить любые подсказки данных, которые вы оставили открытыми ранее.

В следующей таблице приведены сведения о том, как вручную закрыть всплывающие подсказки.

Закрыть целевой объект	Действие
Конкретная подсказка по данным	Выберите X в подсказке данных.
Все советы по данным для конкретного файла	Выберите Отладка>Очистить все подсказки данных, закрепленные на <имя файла> на панели инструментов Visual Studio.
Все советы по открытым данным	Выберите Отладка>Очистить все DataTips на панели инструментов Visual Studio.

Работа с переменными и значениями в подсказках данных

При работе с советами по данным в Visual Studio вы получаете возможность просматривать сведения о переменных и объектах и изменять значения во время отладки. Эти возможности полезны для быстрого устранения неполадок и тестирования изменений в коде.

Разверните объекты в подсказках, чтобы просмотреть члены

Когда подсказка данных представляет массив, структуру или объект, можно развернуть подсказку данных для просмотра элементов. Развернутое представление отображает дополнительные сведения в иерархическом формате дерева.

Чтобы расширить вид объекта в подсказке данных, выполните следующие действия.

В подсказке данных для массива, структуры или объекта выберите стрелку развертывания перед именем элемента, чтобы отобразить элементы. Представление представлено в виде дерева:

Для закрепленной подсказки данных, чтобы развернуть определение, выберите символ плюса (+) перед именем переменной.
Продолжайте выбирать стрелки развертывания, чтобы просмотреть больше иерархии членов.
Чтобы перемещаться вверх и вниз в развернутом представлении, используйте клавиши СТРЕЛКА ВВЕРХ и СТРЕЛКА ВНИЗ.
Чтобы закрепить расширенный элемент вместе с оригинальной закреплённой подсказкой данных, используйте значок кнопки на элементе, чтобы выбрать Закрепить в исходном. После того, как вы свернули древовидное представление, все закрепленные элементы-члены остаются видимыми с прикрепленной подсказкой данных.

Изменение значений переменных

Еще одним преимуществом работы с подсказками по данным является возможность изменять значение переменной или элемента в такой подсказке во время отладки. Эта функция полезна для быстрого тестирования небольших изменений в коде.

Чтобы изменить значение переменной или элемента в подсказке данных, выполните следующие действия.

В подсказке по данным выберите значение. Visual Studio выделяет значение и делает его доступным для редактирования.
Введите новое значение в поле подсказки и нажмите ВВОД.

Помните, что некоторые значения переменных доступны только для чтения. Visual Studio не предоставляет доступные только для чтения значения для редактирования.

Использование комментариев в советах по данным

Комментарии в области данной подсказки данных полезны для хранения заметок о переменных при отладке кода. Это удобное место для отслеживания различных значений при их изменении во время отладки. Комментарии можно добавить в закрепленную или плавающую подсказку данных.

Чтобы использовать примечания в подсказке по данным, выполните следующие действия.

В подсказке данных используйте двойную стрелку вниз для выбора Развернуть, чтобы просмотреть комментарий. Двойная стрелка вниз открывает секцию комментариев в подсказке данных, в которую можно добавлять заметки.
Чтобы добавить комментарий, вставьте курсор в область примечаний и введите текст. Регион принимает несколько строк текста.
Чтобы закрыть регион примечаний , используйте двойную стрелку вверх, чтобы свернуть комментарии . Все примечания, которые вы вводите, остаются с подсказкой данных, но пока не отображаются.

Закрепление свойств в подсказках по данным

Visual Studio поддерживает закрепление свойств в закрепленных подсказках с данными в .NET Core 3.0 и более поздних версиях. Эта функция позволяет быстро инспектировать объекты по их свойствам в подсказках данных.

Чтобы закрепить свойства в подсказках данных, выполните следующие действия.

В закрепленной подсказке данных разверните иерархию элементов, пока не увидите свойство, которое вы хотите оставить видимым вместе с подсказкой данных.
Используйте pushpin для свойства, чтобы закрепить его с помощью подсказки данных. Вы также можете щелкнуть правой кнопкой мыши свойство и выбрать закрепить как избранное.

Visual Studio перемещает выбранное свойство в начало списка свойств объекта. Имя и значение свойства отображаются в правом столбце закрепленной всплывающей подсказки.
Чтобы открепить свойство в подсказке данных, выберите значок кнопки свойства снова или щелкните правой кнопкой мыши свойство и выберите Открепить элемент как избранное.

Вы также можете переключать видимость имён свойств и фильтровать незакреплённые свойства в списке свойств объекта в подсказке по данным.

Чтобы отфильтровать незакрепленные свойства, щелкните правой кнопкой мыши строку свойства в подсказке данных и выберите Показать только закрепленные члены.
Чтобы переключить видимость имен свойств, щелкните правой кнопкой мыши строку свойства в подсказке данных и выберите Скрыть закрепленные имена элементов в значениях.

На следующем рисунке показаны различные параметры в меню правой кнопкой мыши для иерархии элементов в подсказке данных:

Получение помощи по искусственному интеллекту

Если у вас есть Copilot, вы можете получить помощь с поддержкой ИИ во время просмотра переменных в подсказках данных. Щелкните правой кнопкой мыши на переменной и используйте кнопку Ask Copilot. В этом сценарии Copilot уже знает контекст вашего вопроса, поэтому вам не нужно предоставлять контекст в чате. Дополнительные сведения см. в разделе Отладка с помощью Copilot.

Начиная с Visual Studio 2022 версии 17.14, вы также можете получить помощь Copilot благодаря подсказкам данных для выражений LINQ.

Визуализация сложных типов данных

Визуализаторы отображают информацию более значимым, а иногда и графическим образом. Примерами визуализаторов являются XML, HTML, JSON, визуализатор текста, а также табличные визуализаторы. Визуализации можно использовать для изучения сложных типов данных в коде во время отладки.

Если визуализаторы доступны для элемента, Visual Studio отображает вид лупы рядом с именем элемента в подсказке данных. При выборе визуализации Visual Studio открывает отдельное окно для отображения сложных данных в доступном для чтения формате.

Эту функцию можно использовать для выбора визуализации данных:

Чтобы просмотреть элемент с помощью визуализатора по умолчанию для типа данных, выберите увеличивающееся стекло.
Чтобы выбрать конкретный визуализатор, разверните раскрывающийся список представления рядом с лупой и выберите нужный вариант.

Добавьте переменные в окна наблюдения

Вы можете продолжать отслеживать переменные, добавляя их в окно наблюдения в Visual Studio через подсказку данных.

Во всплывающей подсказке щелкните правой кнопкой мыши имя переменной и выберите Добавить наблюдение.

Visual Studio добавляет переменную в окно Watch. Если ваша редакция Visual Studio поддерживает несколько окон Watch, переменная отображается в окне под названием Watch 1.

Советы по импорту и экспорту данных

Подсказки по данным можно экспортировать в XML-файл, которые можно передать или отредактировать с помощью текстового редактора. Вы также можете импортировать подсказки по данным из XML-файла, который вы получили или уже редактировали.

Чтобы экспортировать подсказки по данным, выполните следующие действия.

В Visual Studio выберите Отладка>Экспорт подсказок данных. Откроется диалоговое окно экспорта подсказок данных.
В диалоговом окне найдите папку, в которой нужно сохранить XML-файл.
Введите имя файла экспорта и выберите Сохранить.

Visual Studio экспортирует подсказки по данным в указанный файл и местоположение.

Чтобы импортировать подсказки по данным из файла, выполните следующие действия.

В Visual Studio выберите Отладка>Импорт подсказок данных. Откроется диалоговое окно Импорт подсказок данных.
В диалоговом окне перейдите к расположению XML-файла с подсказками для данных, который будет использоваться для импорта.
Выберите файл, который нужно открыть, и выберите Открыть.

Visual Studio импортирует подсказки данных из указанного файла в текущую рабочую область. При отладке кода рабочей области доступны импортированные советы по данным.

Сначала ознакомьтесь с отладчиком Visual Studio
Ознакомьтесь с методами и средствами отладки
Создавайте пользовательские представления данных в отладчике Visual Studio