Инструменты и среды разработки

Условные точки останова в C#: настройка и примеры

5 мин чтения

Условная точка останова приостанавливает программу только тогда, когда выполняется заданное условие, например счётчик цикла равен 500. Это экономит время при отладке больших циклов и ошибок, которые проявляются на редких значениях. Ниже показано, как её настроить в Visual Studio, какие бывают условия и как не замедлить отладку.

Условные точки останова в C#: настройка и примеры
Содержание
  1. Что такое условные точки останова
  2. Как установить условную точку останова
  3. Когда это полезно
  4. Расширенные примеры условий
    1. Сложные условия
    2. Поиск причины ошибки
    3. Условия с объектами и свойствами
  5. Другие виды условий: число срабатываний и действия
  6. Как не замедлить отладку
  7. Таблица применения условных точек останова
  8. Частые вопросы

Что такое условные точки останова

Отладка - важная часть разработки на C# и в других языках. Обычная точка останова приостанавливает выполнение программы в выбранном месте, а условная делает это только при выполнении условия. Её используют, когда нужно изучить поведение программы при определённых значениях переменных.

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

Как установить условную точку останова

Допустим, нужно остановить программу, когда цикл доходит до значения 500. Возьмём такой код:

for (int i = 0; i < 1000; i++)
{
    Console.WriteLine($"Текущее значение i: {i}");
    // Здесь нужна точка останова
}

Чтобы задать условную точку в Visual Studio, выполните три шага:

  1. Поставьте обычную точку останова. Нажмите слева от номера строки в редакторе или установите курсор на строку и нажмите F9.
  2. Откройте настройки точки. Щёлкните правой кнопкой по красному кружку и выберите "Условия" (в англоязычной версии Conditions), либо наведите курсор на точку и нажмите значок шестерёнки.
  3. Введите условие. Выберите тип "Условное выражение", затем "Значение true" и напишите выражение, например i == 500.

Теперь выполнение приостановится только при i, равном 500. На остальных итерациях отладчик пройдёт точку без остановки.

Когда это полезно

Условные точки особенно нужны там, где обычная остановка слишком частая или слишком редкая:

  • Большие циклы и обработка массивов. Остановка на нужном элементе экономит время и делает отладку точнее.
  • Редкие сценарии. Если ошибка возникает только при определённых значениях переменных, обычная точка не поможет.
  • Проверка логики в особых случаях. Можно увидеть, как программа ведёт себя в сложных ситуациях, не меняя код.

Альтернатива - вставить в код проверку с if и пустой строкой для остановки, но тогда код придётся менять и потом очищать. Условная точка живёт отдельно от кода и не попадёт в репозиторий.

Расширенные примеры условий

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

Сложные условия

Условия не ограничиваются сравнением на равенство. Можно использовать логические операторы && (И) и || (ИЛИ), а также сравнения больше и меньше. Например, для вложенных циклов важно остановиться только на одной комбинации значений:

for (int i = 0; i < 1000; i++)
{
    for (int j = 0; j < 100; j++)
    {
        // Точка останова на этой строке с условием i == 500 && j == 50
        Console.WriteLine($"Текущие значения i: {i}, j: {j}");
    }
}

Условие i == 500 && j == 50 остановит программу, когда обе переменные достигнут нужных значений.

Поиск причины ошибки

Если известно, что ошибка возникает при определённом значении переменной, условная точка помогает остановиться ровно перед сбоем. Например, исключение возникает на элементе с индексом 742: ставим точку внутри цикла с условием i == 742 и пошагово смотрим, что происходит с данными.

Условие может быть и отрицательным: item == null или total < 0. Так удаётся поймать момент, когда данные впервые стали некорректными, а не момент, когда программа уже упала.

Условия с объектами и свойствами

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

public class MyObject
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
}

MyObject[] objects = GetObjects(); // массив объектов из вашего кода

for (int i = 0; i < objects.Length; i++)
{
    // Точка останова с условием objects[i].Name == "ИскомыйОбъект"
    Console.WriteLine($"Объект ID: {objects[i].Id}, Name: {objects[i].Name}");
}

Условие здесь выглядит так: objects[i].Name == "ИскомыйОбъект". Отладчик вычислит его на каждой итерации и остановится только на нужном элементе.

Другие виды условий: число срабатываний и действия

Помимо выражения, в окне настроек точки доступны два других типа условий. "Число срабатываний" останавливает программу, например, на сотом проходе или на каждом десятом. "Фильтр" ограничивает остановку конкретным потоком или процессом, что удобно в многопоточных программах.

Вместо остановки можно выбрать действие: записать сообщение в окно вывода и продолжить работу. Такую точку называют точкой трассировки. Она заменяет временные вызовы Console.WriteLine, при этом исходный код остаётся нетронутым. Значения переменных в сообщении указывают в фигурных скобках, например i = {i}.

Как не замедлить отладку

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

Выражение в условии должно быть простым и без побочных эффектов: не изменяйте в нём переменные и не вызывайте методы, которые что-то записывают. Ошибка в выражении (например, обращение к null) остановит отладчик с сообщением, поэтому добавляйте проверки obj != null && ....

Таблица применения условных точек останова

Сценарий использования Пример условия Примечания
Простые проверки в циклах i == 100 Остановка на определённой итерации цикла
Сложные условные выражения i == 100 && j == 50 Полезно для вложенных циклов и нескольких условий сразу
Отладка специфических ошибок variable == "errorValue" Подходит, когда известно, при каких значениях возникает ошибка
Работа с объектами и свойствами objects[i].Name == "ИскомыйОбъект" Позволяет следить за состоянием отдельных объектов в массивах и коллекциях

Те же приёмы работают в Visual Studio Code и JetBrains Rider: условие задаётся через контекстное меню точки останова, а выражения пишутся на C#.

Частые вопросы

Чем условная точка останова отличается от обычной?

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

Можно ли в условии вызывать методы?

Да, отладчик вычисляет выражения с вызовами простых методов и свойств. Но делать это стоит осторожно: метод выполняется на каждой проверке, замедляет отладку и может изменить состояние программы.

Как остановиться на n-м проходе цикла?

Используйте условие "Число срабатываний" и укажите нужное значение, например "кратно 10" или "равно 500". Это удобно, когда нет подходящей переменной для условного выражения.

Почему условная точка не срабатывает?

Проверьте, что условие записано по правилам C# (двойной знак равенства, регистр имён) и что переменные доступны в этом месте кода. Для проекта должна быть включена отладочная сборка: в оптимизированной сборке часть переменных может быть недоступна.