Создание первого приложения WinUI 3

В этой серии учебников показано, как создать приложение WinUI с помощью XAML и C#. Приложение, которое вы создадите, — это приложение заметок, в котором пользователь может создавать, сохранять и загружать несколько заметок. Вы можете скачать или просмотреть код для этого руководства из репозитория GitHub.

В этом руководстве вы узнаете, как:

  • Используйте разметку XAML для определения пользовательского интерфейса приложения.
  • Взаимодействуйте с элементами XAML с помощью кода C#.
  • Сохраните и загрузите файлы из локальной файловой системы.
  • Создайте представления и привязите их к данным.
  • Используйте навигацию для перехода на страницы в приложении и из нее.
  • Используйте такие ресурсы, как документация и примеры приложений для создания собственного приложения.

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

  • NotePage — страница для редактирования одной заметки.
  • AllNotesPage — страница для отображения всех сохраненных заметок.

Ниже показано итоговое приложение:

AllNotesPage

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

ПримечаниеСтраница

Окончательный снимок экрана приложения заметок с новым пустым примечанием.

Создайте проект Visual Studio

Чтобы начать работу с этим руководством, необходимо создать проект приложения WinUI в Visual Studio с помощью шаблона C# WinUI Blank App (Packaged). При создании project используйте следующие параметры:

  • Название проекта

    Для этого необходимо задать значение WinUINotes. Если project называется чем-то другим, код, который вы копируете и вставляете из этого руководства, может привести к ошибкам сборки. Это связано с тем, что Visual Studio использует имя проекта в качестве пространства имен по умолчанию для кода приложения.

  • Пакет SDK для приложений Windows

    В этом руководстве используются функции, доступные в Windows App SDK версии 1.7 и более поздних версий. Убедитесь, что пакет NuGet Windows App SDK обновлен до версии 1.7 или более поздней.

Это важно

Если вы еще не создали проект WinUI, выполните действия, описанные в Начало разработки приложений Windows, чтобы убедиться, что среда разработки и проект Visual Studio настроены правильно.

При запуске пустого проекта приложения (как описано в Начало разработки приложений для Windows), должно появиться пустое окно, которое выглядит следующим образом:

Окно приложения заметок с строкой заголовка и пустой областью содержимого.

Подсказка

Вы будете часто обращаться к справочным документам по API и концептуальным документам при создании приложений для Windows. В этом руководстве вы увидите ссылки в тексте и в группах, помеченных как "Подробнее в документации:". Эти ссылки являются необязательными; Вам не нужно следовать им, чтобы завершить работу с руководством. Они предоставляются, если вы захотите отметить, где можно найти информацию, которая будет нужна вам, когда вы начнете создавать собственные приложения.