Значок в области уведомлений и toast в Windows-приложении: ошибки NotifyIcon и выбор AppNotification

«Хочу тихо сообщить пользователю, что обработка закончилась». «Хочу, чтобы наблюдение продолжалось, даже если окно закрыли». В бизнес-приложениях эти две задачи обычно идут вместе: значок в области уведомлений (system tray) и toast-уведомления. На практике сразу всплывают мелочи: приложение, которое вроде закрыли, не завершается; после перезапуска Проводника значок пропадает; toast, который шёл на машине разработчика, на целевых ПК не появляется.

К тому же toast-API с эпохи UWP несколько раз сменялись. В поиске легко наткнуться на пример, который сегодня — в лучшем случае «только поддержка». Ниже — как спроектировать значок через NotifyIcon и какой toast-API выбирать в 2026 году, вместе с тем, на чём обычно спотыкаются.

Как читать эту статью

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

Термины в этой статье

1. Сначала выводы

• Значок в области уведомлений по-прежнему делают через System.Windows.Forms.NotifyIcon. Он появится, только если задать Icon и выставить Visible = true (по умолчанию false). Текст подсказки Text начиная с .NET 6 — не длиннее 127 символов (раньше — 63).⁴⁵
• В WPF нет элемента, эквивалентного NotifyIcon. В официальной таблице соответствий прямо сказано «нет эквивалентного элемента». Минимальный вариант — в csproj включить и UseWPF, и UseWindowsForms и взять NotifyIcon из WinForms.⁶⁷
• «По крестику окно закрывается, процесс остаётся в трее» делается так: в FormClosing ставят e.Cancel = true и вызывают Hide(). Отдельный явный выход обязателен (пункт «Выход» в меню значка), и по CloseReason нельзя мешать завершению работы ОС.⁸
• Рекомендация по toast-API на 2026 год однозначна. И для WinForms, и для WPF, и для неупакованного приложения берите AppNotificationManager из Windows App SDK (NuGet: Microsoft.WindowsAppSDK). Windows.UI.Notifications — «только поддержка», компонент уведомлений Community Toolkit архивирован.⁹¹⁰
• AppNotification из Windows App SDK работает и из обычного exe без идентификатора пакета. AppNotificationManager.Default.Register() сам регистрирует COM-сервер и делает работу, эквивалентную AUMID, поэтому ярлык в меню «Пуск», который требовался в прошлом поколении, больше не нужен. Но уведомления из процесса с правами администратора не поддерживаются.¹¹¹²¹³
• Toast — не канал, который «обязательно попадёт в глаза». Пока включён режим «Не беспокоить» (Focus Assist), баннер не показывается, уведомление сразу уходит в центр уведомлений; пользователь может и вовсе отключить уведомления. Не стройте бизнес-процесс на допущении, что «toast был показан».¹⁴¹⁵
• Служба Windows toast показать не может (в сеансе 0 нет UI). Обычная схема — агент со значком в сеансе пользователя и связь по IPC.³

На схеме сплошная линия обозначает отношение, которое выполняется всегда, а пунктирная — условное отношение (условия указаны в пояснении к каждому отношению на странице сведений). Полный список отношений (всего 18, с доказательствами и степенью уверенности) и определения основных понятий собраны на странице сведений карты знаний (на японском). Данные: JSON-LD / Turtle

2. Основы значка в области уведомлений через NotifyIcon

System.Windows.Forms.NotifyIcon — компонент, который ставит значок в область уведомлений в правой части панели задач. Фоновые приложения используют его как точку входа: показать состояние и открыть меню операций.⁴

private NotifyIcon _trayIcon = null!;

private void InitializeTrayIcon()
{
    var menu = new ContextMenuStrip();
    menu.Items.Add("Открыть", null, (_, _) => ShowMainWindow());
    menu.Items.Add(new ToolStripSeparator());
    menu.Items.Add("Выход", null, (_, _) => ExitApplication());

    _trayIcon = new NotifyIcon
    {
        Icon = Properties.Resources.AppIcon, // Icon обязателен; без него значок не появится
        Text = "Мониторинг заказов ── работает",     // подсказка (в .NET 6+ не длиннее 127 символов)
        ContextMenuStrip = menu,
        Visible = true                        // по умолчанию false; true — и только тогда значок виден
    };
    _trayIcon.DoubleClick += (_, _) => ShowMainWindow();
}

Три вещи, которые стоит зафиксировать.

• Значок появляется, только когда заданы и Icon, и Visible = true. У Visible значение по умолчанию — false.⁴
• У Text есть предел длины. С .NET 6 — 127 символов, в .NET 5 и более ранних версиях и в .NET Framework — 63; превышение даёт ArgumentException. Если в подсказку набивать слишком много сведений о состоянии, в какой-то момент приложение просто упадёт на исключении.⁵¹⁶
• Меню по правому щелчку привязывают через ContextMenuStrip. Значок часто остаётся единственной видимой точкой входа, поэтому пункты «Открыть» и «Выход» нужны как минимум.¹⁷

Ещё одно: значок — не только вход для уведомлений, но и постоянно видимый индикатор состояния. Icon и Text можно менять на ходу. Обычный значок в норме, предупреждающий — при сбое, в подсказке — время последней обработки: даже если пользователь пропустил toast, по значку видно, что происходит сейчас. Toast сообщает о событии в этот момент, значок держит текущее состояние — так роли и делятся.

3. «Закрыли окно — осталось в трее» и корректный выход

Классика приложений со значком: крестик не завершает процесс, а только прячет окно. Саму отмену закрытия в FormClosing написать несложно, но если сделать это небрежно, получаются две проблемы: из приложения больше нельзя выйти и Windows не может завершить работу.

private bool _exitRequested;

protected override void OnFormClosing(FormClosingEventArgs e)
{
    // Пользователь нажал только крестик — скрыть, не закрывать
    if (!_exitRequested && e.CloseReason == CloseReason.UserClosing)
    {
        e.Cancel = true;
        Hide();
        return;
    }
    // Пункт «Выход», завершение работы ОС и т. п. — закрывать как обычно
    base.OnFormClosing(e);
}

private void ExitApplication()
{
    _exitRequested = true;
    _trayIcon.Visible = false;
    _trayIcon.Dispose();
    Close();
}

FormClosing срабатывает до закрытия формы; e.Cancel = true отменяет закрытие. CloseReason при этом нужно смотреть всегда. Отменяйте только UserClosing (действие пользователя) и не отменяйте закрытие по инициативе ОС, например WindowsShutDown.⁸¹⁸

В WPF та же идея: в официальной документации прямо описан шаблон e.Cancel = true в Window.Closing и затем Hide().¹⁹

У таких приложений рядом ещё одна проблема: два экземпляра обработают одно и то же событие дважды. Защиту от повторного запуска разбирает статья «Как не дать Windows-приложению запуститься второй раз: именованный Mutex и активация уже работающего экземпляра». Саму «начинку» — цикл наблюдения, периодическую работу — удобно строить на том, что описано в «Зачем в настольном приложении нужны .NET Generic Host и BackgroundService».

4. Значок в области уведомлений в приложении WPF

В WPF нет элемента, эквивалентного NotifyIcon. Это не пробел в документации, а зафиксированное отсутствие: в официальной таблице «элементы WinForms и их аналоги в WPF» стоит «No equivalent control».⁶

Реалистичных варианта два.

Первый вариант — просто два свойства рядом в SDK-style csproj.⁷

<PropertyGroup>
  <TargetFramework>net8.0-windows</TargetFramework>
  <UseWPF>true</UseWPF>
  <UseWindowsForms>true</UseWindowsForms>
</PropertyGroup>

После этого System.Windows.Forms.NotifyIcon создаётся обычным new из Application в WPF. Меню окажется WinForms (ContextMenuStrip), но для меню значка это на практике почти никогда не мешает.

5. Три типичные ошибки со значком в трее

5.1. По умолчанию значок попадает в «скрытые» — принудительно показать его нельзя

Просьба «пусть наш значок всегда виден на панели задач» возникает обязательно, но из программы этого сделать нельзя. В официальной документации сказано прямо: значки по умолчанию попадают в область переполнения (скрытые значки), и решить, поднимать ли значок в постоянно видимую область уведомлений, может только пользователь.¹

В Windows 11 пользователь включает или выключает это для каждого приложения в «Параметры → Персонализация → Панель задач → Другие значки системного лотка». Если постоянная видимость важна в эксплуатации, правильный ответ — написать в инструкции по установке или в справке: «включите этот параметр», а не пытаться навязать его кодом.

В инструкции лучше дать полный путь по меню — тогда можно провести человека и по телефону. Пример текста:

1. Щёлкните правой кнопкой мыши по пустому месту на панели задач и выберите «Параметры панели задач».
2. На открывшейся странице откройте «Другие значки системного лотка».
3. Найдите в списке это приложение и включите переключатель.

※ Если значка не видно, нажмите кнопку «^» (шеврон) справа на панели задач — скрытые значки появятся временно.

5.2. После перезапуска Проводника значок пропадает — TaskbarCreated

Если Проводник падает или перезапускается и пересоздаёт панель задач, уже зарегистрированные значки в области уведомлений исчезают. Оболочка при создании панели задач рассылает сообщение TaskbarCreated всем окнам верхнего уровня; на уровне Win32 правило такое: получили сообщение — зарегистрируйте значок заново.²⁰

NotifyIcon в WinForms обрабатывает это сообщение внутри и перерегистрируется сам, поэтому обычно об этом можно не думать. Если вы вызываете Shell_NotifyIcon через P/Invoke (или сопровождаете нативное приложение со значком в трее), проверьте, что эта повторная регистрация есть. Симптом «после перезапуска Проводника пропал только значок, процесс жив» почти всегда именно этот.

5.3. Без Dispose значок остаётся висеть

На уровне Win32 ненужный значок нужно явно удалить (NIM_DELETE); в WinForms это делает NotifyIcon.Dispose().¹ На пути выхода всегда проходите Visible = false → Dispose(). Если процесс упал и удаление не случилось, значок-призрак висит, пока на него не наведут курсор — любой, кто писал такие приложения, это хотя бы раз видел.

Безопасный вариант — как в коде главы 3: в обработчике «Выход» сначала убрать значок, потом вызвать Close().

6. Toast-уведомления: какой API брать

Toast — баннер в правом нижнем углу, который затем остаётся в центре уведомлений. Способ показать его из настольного приложения за десять лет сменился не один раз, и в поиске полно старых примеров. Картина на 2026 год такая.⁹

Два уточнения.

• ShowBalloonTip — из разряда «старый API, но он жив». В Windows 10 balloon рисуется как toast и до закрытия остаётся в центре уведомлений. В Windows 11 это ближе к прежнему короткому balloon: исчез — в центре уведомлений его нет. Заданное время показа (timeout) сейчас тоже игнорируется, действует настройка специальных возможностей ОС. Для приложения со значком, которое лишь слегка сообщает о смене своего состояния, этого достаточно. Если нужна история в центре уведомлений — в Windows 11 ShowBalloonTip для этого бесполезен.²¹
• У классического способа вызвать «сырой» Windows.UI.Notifications из настольного приложения есть известное ограничение: toast не появится, пока в меню «Пуск» нет ярлыка с AUMID (AppUserModelID).²² Именно эту лишнюю работу убирает AppNotification в следующей главе.

Где кончается «для простых случаев можно», границу удобнее провести по функциям. Если выполнены все пять пунктов ниже, ShowBalloonTip достаточно, зависимость от Windows App SDK наращивать незачем.

• Приложение уже имеет значок в трее (balloon — уведомление при значке, без него его нет)
• На уведомлении не нужны кнопки и поле ввода. Достаточно, чтобы щелчок вывел окно приложения вперёд
• История в центре уведомлений не нужна. В Windows 11 её и не будет, «посмотреть потом» этим API не сделать²¹
• Не нужны прогресс-бар и обновление уже показанного уведомления
• Уведомление — подсказка «заметили — отреагируете быстрее», пропуск не ломает работу

Если выполняется хотя бы один пункт из следующей таблицы, берите AppNotification из главы 7.

Если сомневаетесь, ориентир один: нужно ли пользователю что-то сделать с этим уведомлением. Только прочитать — balloon, нажать — AppNotification.

7. Минимальная реализация Windows App SDK AppNotification

API уведомлений приложений в Windows App SDK работает и из обычного неупакованного exe, без идентификатора пакета.¹¹ Но «поставили NuGet — и готово» здесь нет: есть требования и у разработки, и у доставки. По порядку.

7.1. Подготовка проекта: NuGet и csproj

Официальные предпосылки три: это проект WPF или WinForms на .NET 6 и новее, проект умеет вызывать WinRT API, и он настроен на Windows App SDK.¹²

Делать нужно две вещи. Сначала добавьте NuGet-пакет Microsoft.WindowsAppSDK (в Visual Studio: «Средства → Диспетчер пакетов NuGet → Управление пакетами NuGet для решения»). В этом пакете лежат подпакеты компонентов Windows App SDK; официально рекомендуют начинать именно с основного пакета.²

Затем правьте csproj. Если к примеру из главы 4 (WPF + WinForms) добавить часть Windows App SDK, получится так.

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <!-- Чтобы вызывать WinRT API, в TFM нужна и версия Windows -->
    <TargetFramework>net8.0-windows10.0.19041.0</TargetFramework>
    <UseWPF>true</UseWPF>
    <UseWindowsForms>true</UseWindowsForms>
    <!-- Неупакованное (не MSIX) приложение: runtime инициализируется при старте -->
    <WindowsPackageType>None</WindowsPackageType>
  </PropertyGroup>

  <ItemGroup>
    <!-- Версию подставляет то, что выбрали в диспетчере пакетов NuGet -->
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="(выбранная стабильная версия)" />
  </ItemGroup>
</Project>

Ключ — <WindowsPackageType>None</WindowsPackageType>. Неупакованное приложение должно инициализировать runtime Windows App SDK до любых его функций; это свойство включает автоматическую инициализацию при запуске. После сборки в проект добавляются MddBootstrapAutoInitializer.cs и WindowsAppSDK-VersionInfo.cs. Bootstrap API вызывают напрямую только если нужна более тонкая настройка, вместо автоинициализации.²

7.2. Доставка runtime на целевые машины

Это часто пропускают. Для неупакованного приложения доставить runtime Windows App SDK на ПК пользователя — обязанность того, кто распространяет приложение.²³ Одного exe недостаточно.

Отдельно: неупакованному приложению нужен и распространяемый компонент Visual C++.²³ Способов доставки два.

У установщика нет UI, его вызывают цепочкой из своего установщика. Есть режим без участия пользователя.²³

:: Установить без окон и без текстового вывода
WindowsAppRuntimeInstall.exe --quiet

:: Принудительно обновить, завершив процессы, которые используют Windows App SDK (с 1.1)
WindowsAppRuntimeInstall.exe --force

Три вещи, которые стоит знать при установке.²³

• Есть ли права администратора — от этого зависит результат. Если установщик запущен с повышением и у пользователя есть права администратора, регистрация идёт на всю систему (включая будущих пользователей). Иначе ставится только для того, кто запустил. Код возврата 0x80070005 как раз про «нет повышения / нет прав администратора».
• Успех смотрят по коду возврата. 0x0 — успех, 0x80073d06 — не удалось установить один или несколько пакетов. Если вызываете цепочкой из своего установщика, этот код нужно проверять всегда.
• Runtime на машине разработчика должен совпадать с версией и каналом выпуска NuGet-пакета, на который ссылается проект.² «На разработке показывается, у клиента — нет» часто начинается отсюда.

Если распространяете как MSIX, runtime можно объявить зависимостью пакета, но тогда в Package.appxmanifest нужно прописать COM-активатор (см. конец 7.3).

7.3. Минимальная реализация

using System;
using System.Windows.Forms;
using Microsoft.Windows.AppNotifications;
using Microsoft.Windows.AppNotifications.Builder;

internal static class ToastActivation
{
    private static readonly object Gate = new();
    private static Action? _pending;
    private static bool _uiReady;

    // Один раз при старте. Порядок важен: сначала обработчик, затем Register()
    public static void Initialize()
    {
        AppNotificationManager.Default.NotificationInvoked += (_, args) =>
        {
            // Сюда приходят щелчок по toast и нажатие кнопки (различайте по args.Arguments)
            if (!args.Arguments.TryGetValue("action", out var action) || action != "openLog")
            {
                return;
            }

            // NotificationInvoked приходит на фоновом потоке.
            // Всё, что трогает UI, обязательно передавайте на UI-поток
            Dispatch(ShowLogWindow);
        };
        AppNotificationManager.Default.Register();
    }

    // Вызывать из OnShown у MainForm. Здесь проигрывается то, что пришло до появления формы
    public static void MarkUiReady()
    {
        Action? pending;
        lock (Gate)
        {
            _uiReady = true;
            pending = _pending;
            _pending = null;
        }
        // OnShown уже на UI-потоке, выполнять можно сразу
        pending?.Invoke();
    }

    private static void Dispatch(Action action)
    {
        lock (Gate)
        {
            if (!_uiReady)
            {
                // Щелчок по toast сам запустил приложение: в этот момент
                // ещё нет ни одной формы. Откладываем, MarkUiReady проиграет позже
                _pending = action;
                return;
            }
        }
        MainWindow()?.Invoke(action);
        // Для WPF: Application.Current.Dispatcher.Invoke(action);
    }

    private static Form? MainWindow() =>
        Application.OpenForms.Count > 0 ? Application.OpenForms[0] : null;

    private static void ShowLogWindow() { /* открыть окно журнала */ }
}

// Сторона MainForm. Если приложение стартовало по щелчку по toast, действие подхватывается здесь
protected override void OnShown(EventArgs e)
{
    base.OnShown(e);
    ToastActivation.MarkUiReady();
}

ToastActivation.Initialize();

// Показать уведомление
var notification = new AppNotificationBuilder()
    .AddText("Импорт заказов завершён")
    .AddText("12 новых, 1 ошибка")
    .AddButton(new AppNotificationButton("Открыть журнал")
        .AddArgument("action", "openLog"))
    .BuildNotification();
AppNotificationManager.Default.Show(notification);

На практике важно следующее.

• На NotificationInvoked подписывайтесь до Register(). Перепутаете порядок — пропустите событие, когда щелчок по toast запускает приложение.¹²
• Если приложение стартовало по щелчку, в момент обработчика ещё нет ни одной формы. Если смотреть Application.OpenForms и при null ничего не делать, действие на этом пути молча теряется. Как выше: отложите его и проиграйте, когда форма уже показана. Даже если событие вы получили в правильном порядке, выбросить его здесь — тот же результат.
• NotificationInvoked приходит на фоновом потоке. В официальном примере прямо сказано: событие на фоновом потоке, обновление UI нужно диспетчеризовать на UI-поток. Если из обработчика сразу открывать окна и трогать элементы, получите исключения по потокам или необъяснимые зависания. В WPF — Application.Current.Dispatcher.Invoke(...), в WinForms — Control.Invoke(...).¹²
• Перед выходом вызывайте AppNotificationManager.Default.Unregister(). В документации сказано: Unregister перед завершением освобождает ресурсы и позволяет следующему щелчку по уведомлению корректно запустить приложение. Встройте это в обработчик «Выход» из главы 3 рядом с NotifyIcon.Dispose() (есть ещё UnregisterAll() — стереть регистрацию целиком, если приложение снимают и уведомлениями больше пользоваться не будут).²⁴
• В неупакованном приложении Register() сам регистрирует COM-сервер и делает работу, эквивалентную AUMID. Ярлык и записи в реестре, которые требовал «сырой» WinRT, больше не нужны. Если упаковываете в MSIX, наоборот, COM-активатор нужно прописать в Package.appxmanifest.¹²
• Если выбираете self-contained доставку с встроенным runtime Windows App SDK, осторожнее. AppNotificationManager зависит от пакета Singleton Windows App SDK; для вызова из self-contained приложения есть официальные оговорки. Прочитайте их до выбора способа распространения.²⁵
• Уведомления из процесса с правами администратора не поддерживаются. Show не бросает исключение и тихо ничего не показывает — причину легко не заметить. Если приложению нужно повышение прав, имеет смысл отдать показ уведомлений отдельному процессу без повышения (этот приём разобран в «Как в Windows-приложении вынести только те операции, которым нужны права администратора»).¹³
• Если по щелчку по toast приложение не запущено, стартует новый процесс. В приложении со значком это нужно сочетать с защитой от повторного запуска (глава 3) и передавать работу уже существующему экземпляру.

8. Следующий шаг: toast с прогресс-баром и уборка уведомлений

8.1. Обновлять прогресс внутри toast — UpdateAsync

Для долгой операции вроде «идёт импорт 120 записей заказов» правильный ход — не слать новое уведомление снова и снова, а переписывать прогресс-бар внутри одного toast. У AppNotification для этого есть привязка данных и обновление.²⁶

Сборка в три шага. Сначала каждое значение прогресс-бара делаете заполнителем через методы Bind, помечаете уведомление Tag (и при необходимости Group) и показываете. Дальше достаточно передать AppNotificationProgressData в UpdateAsync — меняется только содержимое уже показанного toast.

const string tag = "import-progress";
const string group = "batch";

// Первый показ: значения — привязки, начальное значение задаётся в Progress
var notification = new AppNotificationBuilder()
    .AddText("Идёт импорт данных заказов")
    .AddProgressBar(new AppNotificationProgressBar()
        .BindStatus().BindValue().BindValueStringOverride())
    .SetTag(tag)
    .SetGroup(group)
    .BuildNotification();

notification.Progress = new AppNotificationProgressData(1) // порядковый номер
{
    Status = "Импорт...", Value = 0, ValueStringOverride = "0/120 записей"
};
AppNotificationManager.Default.Show(notification);

// При каждом шаге прогресса: увеличить номер и обновить
var data = new AppNotificationProgressData(2)
{
    Status = "Импорт...", Value = 45 / 120.0, ValueStringOverride = "45/120 записей"
};
await AppNotificationManager.Default.UpdateAsync(data, tag, group);

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

8.2. Когда «обновлять», а когда «заменять»

Внешне «обновить» можно и повторным Show нового уведомления с тем же Tag — это замена, — но поведение другое.²⁶

Официальная рекомендация тоже ясна: ход работы — обновлять, завершение — заменять. Нет смысла всплывать баннером на каждый шаг с 50% на 65%, а «импорт завершён (3 ошибки)» должно дойти, даже если пользователь уже закрыл уведомление о прогрессе. На практике при завершении убирают прогресс-бар и подставляют другой макет с кнопками вроде «Посмотреть ошибки».

8.3. Убрать старые уведомления из центра уведомлений

Toast копятся в центре уведомлений, пока пользователь их не снимет. Если приложение каждый день шлёт по нескольку штук, центр забивается вашими старыми уведомлениями, и важное тонет.

С Tag / Group свои уведомления можно удалять из кода (по тегу, по группе, все сразу). Можно задать и срок жизни. Правила уборки — «прогресс снимать по завершении», «информационным давать короткий срок» — лучше решить в тот же момент, когда решаете, какие уведомления слать.²⁸

9. Заложить в дизайн случаи, когда уведомление «не доходит»

Toast — не надёжный канал доставки. Есть нормальные пути, на которых он не показывается или остаётся незамеченным.

Режим «не беспокоить» в Windows 10 — это «Фокусировка внимания» (Focus assist), в Windows 11 — переключатель «Не беспокоить» в «Параметры → Система → Уведомления»; им управляет пользователь или групповая политика. Есть даже правило: в первый час после обновления ОС режим включается сам.¹⁴ Фокусировка внимания — не «не слать уведомления», а «не показывать баннер и отправить в центр уведомлений»: позже в центре уведомлений пользователь их увидит.¹⁵

Где смотреть — держите полным путём по меню, на месте это быстрее. «Уведомление не появляется» часто разбирают по телефону или в чате.

В Windows 10 аналог «не беспокоить» — «Параметры → Система → Фокусировка внимания». Сначала проверьте, дошло ли уведомление в центр уведомлений: если дошло — ОС подавила баннер (режим «Не беспокоить» и т. п.), если нет — смотрите отправку со стороны приложения.

Для дизайна вывод простой.

• Toast — вспомогательный канал: заметили — отреагируете быстрее. Информацию, без которой работа не идёт, всегда можно найти на экране или в списке внутри приложения. Не стройте процесс на том, что «toast наверняка показали».
• Если прервать всё же нужно (например, предупреждение об аварийной остановке), есть AppNotificationScenario.Urgent (важное уведомление): с согласия пользователя оно проходит сквозь режим «Не беспокоить»²⁹, но если злоупотреблять, пользователь выключит уведомления приложения целиком. Оставляйте это только для действительно неотложных случаев.

Как показывать на экране состояние внешнего оборудования — более широкая тема, см. «Как проверять и показывать состояние внешнего оборудования».

10. Когда нужно уведомить пользователя из службы Windows

Требование звучит естественно: «фоновая служба нашла сбой — пусть вошедшему пользователю придёт toast». Но служба не может показать toast напрямую. С Windows Vista службы работают в отдельном сеансе 0 и не могут показывать UI, с которым взаимодействует пользователь.³

Обычная схема — вынести UI в процесс в сеансе пользователя.

[Сеанс 0]                          [Сеанс пользователя]
 Служба Windows    ←─ IPC ─→    Агент со значком в трее
 (мониторинг и бизнес-логика)   именованные каналы и т. п.   (NotifyIcon + AppNotification)

• Служба занимается наблюдением и бизнес-логикой и по IPC передаёт агенту то, о чём нужно сообщить.
• Агент — приложение со значком в области уведомлений (как раз главы 2–8 этой статьи), которое стартует при входе пользователя и показывает полученные события toast или сменой значка.
• Выбор IPC разобран в «Как выбрать межпроцессное взаимодействие в Windows», устройство службы — в «Как устроить службу Windows и как её эксплуатировать», сами сеансы — в «Как понимать изоляцию сеансов Windows: Session 0, RDP и несколько пользователей сразу».

Если одновременно входят несколько пользователей (RDP, общий терминал), агент работает по одному на сеанс. Заранее зафиксируйте требование «кому слать» (всем или только определённому пользователю) — тогда схема не разъедется.

11. Итог

• Значок в трее — это NotifyIcon. Показ: Icon + Visible = true; у Text лимит 127 символов (.NET 6+); на выходе обязательно Dispose(). Значок и подсказку используйте и как постоянно видимый индикатор текущего состояния.
• «По крестику остаться в трее» делается отменой FormClosing, но отменяйте только CloseReason.UserClosing и всегда давайте явный пункт «Выход».
• Постоянно показывать значок может решить только пользователь. Исчезновение после перезапуска Проводника закрывается повторной регистрацией по TaskbarCreated (в WinForms — автоматически).
• Для нового toast один выбор: AppNotificationManager из Windows App SDK. Работает и из неупакованного exe без идентификатора пакета, Register() сам закрывает нудную регистрацию. Уведомления Community Toolkit архивированы, «сырой» WinRT — только поддержка. Если не нужны ни кнопки, ни история, ни прогресс, лёгкое уведомление можно оставить на ShowBalloonTip (глава 6).
• Для неупакованного приложения доставить runtime Windows App SDK на целевые машины — обязанность того, кто распространяет приложение. В csproj пишите <WindowsPackageType>None</WindowsPackageType> и в свой установщик закладывайте цепочку с WindowsAppRuntimeInstall.exe (глава 7.2).
• Ход долгой операции тихо переписывайте прогресс-баром в одном toast через UpdateAsync, завершение — заменой с баннером. Вешайте Tag/Group и закладывайте удаление старых уведомлений.
• Toast может не дойти из-за режима «Не беспокоить» или выключенных уведомлений — это вспомогательный канал. Обязательную информацию держите доступной внутри приложения и помните: из процесса с повышенными правами уведомления не поддерживаются.
• Уведомление от службы делается разделением: агент со значком в сеансе пользователя плюс IPC.

Похожие статьи

• Как не дать Windows-приложению запуститься второй раз: именованный Mutex и активация уже работающего экземпляра
• Как устроить службу Windows и как её эксплуатировать: служба или планировщик заданий, и как сделать службу из BackgroundService
• Как выбрать межпроцессное взаимодействие в Windows: именованные каналы / TCP / gRPC / общая память / COM
• Как понимать изоляцию сеансов Windows: Session 0, RDP и несколько пользователей сразу
• Зачем в настольном приложении нужны .NET Generic Host и BackgroundService
• Как в Windows-приложении вынести только те операции, которым нужны права администратора
• Как проверять и показывать состояние внешнего оборудования — не ограничиваться статусом «подключено»

Смежные области консультаций

KomuraSoft LLC (合同会社小村ソフト) проектирует и реализует инструменты наблюдения со значком в области уведомлений и агенты уведомлений, разбирает схемы фоновых систем в связке со службами Windows и ищет причины сбоев в уже существующих таких приложениях.

• Разработка Windows-приложений
• Техническая консультация и ревью архитектуры
• Связаться с нами

Источники

Похожие статьи

Недавние статьи с теми же тегами помогут подробнее изучить близкие темы.

Связанные темы

Эти страницы показывают тему статьи в более широком контексте услуг и решений.

Услуги по этой теме

Статья напрямую связана со следующими услугами.

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

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

Как в WPF сделать приложение со значком в области уведомлений?

В WPF нет элемента, эквивалентного NotifyIcon, поэтому минимальный вариант — в csproj включить и UseWPF, и UseWindowsForms и взять NotifyIcon из WinForms. Если хочется писать ближе к XAML, есть сторонние библиотеки вроде H.NotifyIcon, но это не официальный компонент Microsoft — учитывайте это при выборе.

Какой API брать для toast-уведомлений?

Для новой реализации в 2026 году официальная рекомендация одна: AppNotificationManager из Windows App SDK, и для WinForms, и для WPF, и для неупакованного приложения. Microsoft.Toolkit.Uwp.Notifications архивирован и в актуальный Community Toolkit не входит, а WinRT ToastNotificationManager — только поддержка. Если существующий код на одном из двух последних уже работает, переписывать срочно не нужно, но выбирать их для нового проекта незачем.

Что проверить, если toast не показывается?

Сначала настройки ОС. Если включён режим «Не беспокоить» (Focus Assist), баннер не появляется, уведомление сразу уходит в центр уведомлений; то же самое, если уведомления выключены для приложения или для всей системы в «Параметрах». На стороне кода типичны два случая: AppNotification из процесса с правами администратора не поддерживается и молча не показывается, а «сырой» Windows.UI.Notifications из настольного приложения без AUMID тоже ничего не рисует.

Может ли служба Windows показывать toast-уведомления?

Нет. Начиная с Windows Vista службы работают в сеансе 0 и не могут показывать UI, с которым взаимодействует пользователь. Если нужно уведомить пользователя, обычная схема — процесс-агент со значком в области уведомлений в сеансе пользователя и связь со службой по IPC, например через именованные каналы; показ уведомления делает агент.

Об авторе

Страница с профилем автора статьи.

Го Комура

Представитель KomuraSoft LLC

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