Исправление: Windows.Storage namespace не найден

Изображение пространства имён Windows.Storage

Что такое Windows.Storage?

Windows.Storage — это пространство имён Windows Runtime (WinRT), содержащее классы для работы с файлами, папками и настройками приложений: StorageFile, StorageFolder, ApplicationData и т.п. Коротко: предоставляет API для управления хранилищем данных приложения и доступа к файловой системе в контексте UWP/WinRT.

Короткое определение терминов:

WinRT — платформа API, основная для UWP-приложений.
WINMD — мета-данные Windows Runtime в виде файлов .winmd, нужные для привязки типов WinRT.

Почему появляется ошибка «Windows.Storage namespace не найден»?

Наиболее частые причины:

Проект не содержит правильных ссылок на WINMD/DLL (System.Runtime.WindowsRuntime.dll, Windows.winmd и т. п.).
Обозреватель объектов Visual Studio настроен неправильно (по умолчанию — All Components вместо набора совместимых компонентов).
Проект целится не в UWP/WinRT, а в чистый .NET Framework/.NET Core без поддержки WinRT.
Путём путаницы сообщение может ссылаться на System.Windows.* (WPF), а не на Windows.Storage (WinRT). Это разные корневые пространства.

Важно: System.Windows.Storage не равно Windows.Storage. Первое относится к WPF/.NET, второе — к WinRT/UWP.

Быстрая проверка перед изменениями (Check-list)

Убедитесь, что проект — UWP или Portable Class Library/Windows Runtime Component, поддерживающий WinRT.
В Visual Studio откройте Solution Explorer и проверьте References/Ссылки.
Посмотрите, есть ли в проекте ссылка на Windows.winmd и на System.Runtime.WindowsRuntime.dll.
Если используете .NET Core/5+/6+, проверьте, нужен ли вам пакет Windows Compatibility или UwpDesktop.

Подробные шаги по исправлению

1. Ручное добавление ссылок на UWP DLL и WINMD

В Visual Studio откройте Solution Explorer, кликните правой кнопкой по References и выберите Add Reference.
В Reference Manager слева выберите Browse и перейдите в папку: C:\Program Files (x86)\Windows Kits\10\UnionMetadata\winmd
Из этой папки добавьте нужный файл Windows.winmd в проект и установите фильтр файлов в All Files, если он не виден.
Повторите Add Reference и в Browse найдите: C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework.NETCore\v4.5
Добавьте System.Runtime.WindowsRuntime.dll в проект.

Примечание: путь к SDK может отличаться в зависимости от версии Windows SDK и установки Visual Studio. Если файла нет, установите соответствующий Windows 10/11 SDK через установщик Visual Studio или отдельный SDK-пакет.

Важно: после добавления ссылок пересоберите проект и проверьте, исчезла ли ошибка.

2. Правильное использование Обозревателя объектов (Object Browser)

По умолчанию Object Browser показывает All Components. Для старых проектов выберите .NET Portable Subset (Visual Studio 2013).
Чтобы найти Windows.Storage, в Object Browser ищите Windows.winmd.
Выделите нужный компонент и нажмите Add to References для выбранного проекта в Solution Explorer.

Это добавит ссылку в проект Portable Library, и вы сможете использовать StorageFolder и другие типы в коде.

3. Использование NuGet-пакетов и альтернатив

Если вы не хотите или не можете менять целевую платформу или устанавливать Windows SDK, используйте NuGet:

UwpDesktop — проект/пакет, позволяющий получить некоторые Windows API в десктопных приложениях. Исходники доступны на GitHub.
Windows compatibility pack и Microsoft.Windows.Compatibility помогают с переносом кода, но они не всегда предоставляют WinRT-типов.

Когда использовать NuGet: если проект — .NET Core/.NET 5+/6+ и нужна совместимость с Windows API без полной миграции в UWP.

Когда это решение не сработает (примеры)

Если вы разрабатываете чистый WPF-приложение без планов интегрировать WinRT — добавление Windows.winmd не даст полной поддержки WinRT-типов в рантайме.
На серверных сборках без установленного Windows SDK ссылки на WINMD не помогут; нужны целевые среды с поддержкой WinRT.

Методология устранения неисправности (минимальная)

Диагностика: определить тип проекта и целевую платформу.
Проверка ссылок: Windows.winmd и System.Runtime.WindowsRuntime.dll.
Попробовать добавить ссылку вручную или через Object Browser.
Если невозможна прямая привязка, рассмотреть NuGet-решения (UwpDesktop) или переработку функционала под совместимые API.
Пересобрать и тестировать.

Сводная проверочная таблица (быстрая)

Проект UWP: да → добавьте ссылку на Windows.winmd и используйте API напрямую.
Проект WPF/.NET Framework: хотите WinRT? → используйте мосты/пакеты или рефакторинг.
.NET Core/5+/6+: попробуйте UwpDesktop или переработайте под безопасные аналоги.

Decision flow (решение в виде диаграммы)

flowchart TD
  A[Ошибка: Windows.Storage не найден] --> B{Проект UWP/WinRT?}
  B -- Да --> C[Есть Windows.winmd и System.Runtime.WindowsRuntime.dll?]
  C -- Да --> D[Пересобрать проект и тестировать]
  C -- Нет --> E[Добавить ссылки из Windows SDK]
  B -- Нет --> F{Целевой .NET Core / .NET 5+ ?}
  F -- Да --> G[Попробовать UwpDesktop или альтернативы NuGet]
  F -- Нет --> H[Переработать код под соответствующий API '.NET/WPF']
  E --> D
  G --> D
  H --> D

Критерии приёмки

Проект компилируется без ошибок, связанных с пространством имён Windows.Storage.
В рантайме методы StorageFile/StorageFolder выполняются и возвращают ожидаемые результаты.
Пакет/ссылки задокументированы в репозитории и в README проекта.

Роль‑ориентированные чек‑листы

Для разработчика:

Проверил тип проекта и целевую платформу.
Добавил Windows.winmd и System.Runtime.WindowsRuntime.dll при необходимости.
Запустил unit-тесты, покрывающие доступ к файлам.

Для ревьюера кода:

Подтвердил изменения в ссылках и отсутствие «хардкодных» локальных путей.
Проверил, что добавленные NuGet-пакеты имеют лицензию, совместимую с проектом.

Для релиз-инженера:

Убедился, что сборочные агенты имеют установленный Windows SDK или нужные зависимости.
Обновил инструкции по сборке CI/CD.

Совместимость и рекомендации

UWP/WinRT: полная поддержка Windows.Storage.
WPF на .NET Framework: работает через COM/мосты, но предпочтительнее использовать System.IO или Windows API через interop.
.NET Core и .NET 5+: используйте совместимые пакеты; прямой доступ к WinRT ограничен.

Частые ошибки и их исправления

Ошибка: «Не удаётся найти Windows.winmd» → Установите Windows 10/11 SDK или укажите корректный путь.
Ошибка: «Тип из пространства имён не распознан» → Убедитесь, что указаны using Windows.Storage; и что ваша сборка поддерживает WinRT.
Ошибка при выполнении на CI → Добавьте шаг установки Windows SDK или используйте образ агента с уже установленным SDK.

Короткий глоссарий

WINMD — файл метаданных WinRT, нужен для компиляции с WinRT-типами.
StorageFile / StorageFolder — WinRT-классы для работы с файлами и папками.

Резюме

Если Windows.Storage не найден, чаще всего это связано с отсутствием правильных ссылок (Windows.winmd, System.Runtime.WindowsRuntime.dll) или с тем, что проект не рассчитан на использование WinRT. Решения: добавить ссылки вручную, правильно использовать Object Browser или подключить совместимый NuGet-пакет (UwpDesktop). В конце убедитесь, что сборочная среда имеет нужный Windows SDK и что изменения задокументированы.

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

Дополнительно: если приложение UWP на Windows 11 тормозит или зависает, посмотрите отдельную статью с рекомендациями по производительности для UWP (поиск и исправление причин лагов выходит за рамки этой инструкции).