Диалоговое окно MessageBox в C# Windows Forms

Обновлено: 31.10.2026 · 6 мин чтения

Что такое MessageBox и как его вызвать

Класс MessageBox находится в пространстве имён System.Windows.Forms и содержит единственный практически нужный метод - статический Show. Он показывает модальное окно: пока пользователь не нажмёт кнопку, остальные окна приложения недоступны, а выполнение кода останавливается на вызове. Результат возвращается как значение перечисления DialogResult.

MessageBox.Show("Файл сохранён.");

В проекте Windows Forms подключать ничего дополнительно не нужно. В консольном приложении или проекте на .NET 8 без Windows Forms класса не будет: понадобится указать <UseWindowsForms>true</UseWindowsForms> в файле проекта и целевую платформу Windows, о чём подробнее в разделе про консоль.

Перегрузки метода Show

Метод имеет больше десятка перегрузок, но все они строятся из одних и тех же параметров. Основные сведены в таблицу.

Чаще всего используется вариант из четырёх аргументов: текст, заголовок, кнопки и значок.

MessageBox.Show(
    "Не удалось подключиться к серверу.",
    "Ошибка подключения",
    MessageBoxButtons.OK,
    MessageBoxIcon.Error);

Кнопки MessageBoxButtons

Перечисление определяет, какие кнопки увидит пользователь. Выбирайте набор под смысл вопроса: для информирования хватит OK, для подтверждения - YesNo, а для действия, которое можно отменить - YesNoCancel.

Надписи на кнопках подстраиваются под язык операционной системы, поэтому на русской Windows пользователь увидит "Да" и "Нет" без вашего участия. Изменить подписи стандартным способом нельзя: если нужны свои тексты, например "Сохранить" и "Не сохранять", создайте собственную форму.

Значки MessageBoxIcon

Значок подсказывает уровень важности и сопровождается системным звуком. Не злоупотребляйте им: ошибкой помечайте только настоящие сбои, а предупреждение используйте для действий с риском.

• Information - обычное сообщение: "Операция завершена".
• Warning - предупреждение: "Файл будет перезаписан".
• Error (он же Stop и Hand) - ошибка выполнения.
• Question - вопрос пользователю.
• None - без значка.

Обработка ответа пользователя

Возвращаемое значение DialogResult показывает, какую кнопку нажали. Закрытие окна крестиком даёт тот же результат, что и кнопка Cancel, либо No, если Cancel в наборе нет, и это нужно учитывать.

DialogResult result = MessageBox.Show(
    "Удалить выбранный файл?",
    "Подтверждение",
    MessageBoxButtons.YesNo,
    MessageBoxIcon.Question,
    MessageBoxDefaultButton.Button2);

if (result == DialogResult.Yes)
{
    File.Delete(path);
}

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

switch (MessageBox.Show("Сохранить изменения?", "Закрытие",
        MessageBoxButtons.YesNoCancel, MessageBoxIcon.Warning))
{
    case DialogResult.Yes:
        SaveDocument();
        break;
    case DialogResult.No:
        break;
    case DialogResult.Cancel:
        return;
}

Подтверждение закрытия формы

Один из самых частых сценариев - спросить пользователя перед выходом, если в окне остались несохранённые данные. Для этого подпишитесь на событие FormClosing и отмените закрытие через свойство Cancel.

private bool _isDirty;

private void MainForm_FormClosing(object? sender, FormClosingEventArgs e)
{
    if (!_isDirty) return;

    var answer = MessageBox.Show(
        "Есть несохранённые изменения. Сохранить их?",
        "Закрытие программы",
        MessageBoxButtons.YesNoCancel,
        MessageBoxIcon.Warning);

    if (answer == DialogResult.Cancel)
        e.Cancel = true;
    else if (answer == DialogResult.Yes)
        SaveDocument();
}

Не показывайте диалог, если закрытие инициировала сама система (выключение Windows): проверяйте e.CloseReason == CloseReason.UserClosing, иначе окно может заблокировать завершение работы системы.

Показ ошибок и исключений

Типичное применение - сообщить об исключении. Выводите понятный текст, а технические детали убирайте в журнал. Показывать пользователю ex.ToString() с трассировкой стека не стоит: он не поймёт, что делать, а часть сведений лучше не раскрывать.

try
{
    string text = File.ReadAllText(path);
    textBox1.Text = text;
}
catch (FileNotFoundException)
{
    MessageBox.Show($"Файл не найден:\n{path}", "Ошибка",
        MessageBoxButtons.OK, MessageBoxIcon.Error);
}
catch (UnauthorizedAccessException)
{
    MessageBox.Show("Нет доступа к файлу.", "Ошибка",
        MessageBoxButtons.OK, MessageBoxIcon.Error);
}

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

Вывод значений и форматирование текста

MessageBox принимает только строку, поэтому числа и даты нужно преобразовать. Интерполяция делает это компактно, а формат задаётся после двоеточия. Если нужно показать число в поле формы, а не в окне, пригодится статья про вывод числа в TextBox.

double price = 1234.5;
MessageBox.Show($"Итого: {price:N2} руб.\nДата: {DateTime.Now:dd.MM.yyyy HH:mm}",
    "Заказ", MessageBoxButtons.OK, MessageBoxIcon.Information);

// Показать элементы списка
MessageBox.Show(string.Join(Environment.NewLine, listBox1.Items.Cast<object>()));

Владелец окна и расположение

Если вызвать Show без владельца, окно появится по центру экрана и может оказаться позади формы. Передайте как первый аргумент текущую форму (this), и диалог встанет поверх неё, по центру владельца.

MessageBox.Show(this, "Готово", "Информация",
    MessageBoxButtons.OK, MessageBoxIcon.Information);

Положение окна и размеры сообщения изменить нельзя: ширина ограничена системой, а длинный текст переносится автоматически. Слишком большие сообщения лучше показывать в собственной форме с полем TextBox или RichTextBox и кнопкой "Копировать".

Консоль, WPF и другие платформы

Класс из Windows Forms работает в любом приложении Windows при подключённой сборке, но способ подключения зависит от проекта.

• Консоль на .NET Framework: добавьте ссылку на сборку System.Windows.Forms и пишите using System.Windows.Forms;.
• Консоль на .NET 8: в файле проекта укажите <TargetFramework>net8.0-windows</TargetFramework> и <UseWindowsForms>true</UseWindowsForms>.
• WPF имеет собственный класс System.Windows.MessageBox с тем же методом Show, но с перечислениями MessageBoxButton и MessageBoxImage и результатом MessageBoxResult.
• ASP.NET и Linux: MessageBox недоступен, сообщения показывают средствами веб-страницы или логами.

// WPF
var r = System.Windows.MessageBox.Show("Продолжить?", "Вопрос",
    System.Windows.MessageBoxButton.YesNo, System.Windows.MessageBoxImage.Question);
if (r == System.Windows.MessageBoxResult.Yes) { /* ... */ }

Для конфликтующих имён в одном файле (подключены и Forms, и WPF) указывайте полное имя класса, как в примере.

Типичные ошибки и советы

• Вызов MessageBox из фонового потока работает, но окно может появиться позади основного. Лучше возвращаться в поток интерфейса, как описано в статье про обновление интерфейса из другого потока.
• Сообщение внутри цикла: десятки подряд идущих окон выводят пользователя из себя. Накапливайте ошибки и показывайте одним окном.
• Использование MessageBox для отладки: удобно, но блокирует поток. Для диагностики лучше Debug.WriteLine или журнал.
• Сравнение результата со строками вместо DialogResult.
• Слишком длинный текст и сообщения вроде "Ошибка!" без объяснения. Пишите, что случилось и что можно сделать.
• Диалог, который появляется при каждом действии: пользователь привыкает нажимать "Да" не читая. Подтверждение имеет смысл только для необратимых действий.

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