Руководство. Создание первого приложения пакета SDK для приложений Windows в Visual Studio с помощью XAML и C#

В этом руководстве по интегрированной среде разработки Visual Studio вы создадите приложение Hello World, которое работает на любом устройстве с Windows 10 или более поздней версии. Для этого вы будете использовать шаблон проекта пакета SDK для приложений Windows (WinUI 3), язык разметки расширяемых приложений (XAML) и язык программирования C#.

Если вы еще не установили Visual Studio, перейдите на страницу загрузки Visual Studio, чтобы установить её бесплатно.

Создание проекта

Сначала создайте проект WinUI 3. Тип проекта включает в себя все необходимые файлы шаблона, еще до того, как вы что-либо добавите!

1. Откройте Visual Studio и в окне запуска выберите Создать проект.

2. На экране Создание нового проекта введите WinUI в поле поиска, выберите шаблон C# для пустого приложения, упакованный (WinUI 3 на рабочем столе), и нажмите кнопку Далее.

   

3. Присвойте проекту имя, HelloWorldи выберите Создать.

   

   Заметка

   Если вы впервые используете Visual Studio для создания приложения Windows App SDK, может появиться диалоговое окно настроек . Выберите режим разработчика, а затем выберите Да.
   
   
   
   Visual Studio устанавливает дополнительный пакет режима разработчика. По завершении установки пакета закройте диалоговое окно "Параметры".

Создание приложения

Пришло время начать разработку. Вы добавите элемент управления кнопкой, добавьте действие в кнопку, а затем запустите приложение Hello World, чтобы увидеть, как это выглядит.

Добавление кнопки на холст конструктора

1. В Обозревателе решенийдважды щелкните MainWindow.xaml, чтобы открыть редактор разметки XAML.

   

   В редакторе XAML можно добавить или изменить разметку. В отличие от проектов UWP, WinUI 3 не имеет режима проектирования .

   

2. Просмотрите кнопку , элемент управления, вложенный в StackPanel , находящийся в корне окна .

   

Изменение метки на кнопке

1. В редакторе XAMLизмените значение содержимого кнопки с "Click me" на "Hello World!".

   

2. Обратите внимание, что для кнопки также указан обработчик событий Click с именем myButton_Click. Мы перейдем к этой области на следующем шаге.

   

Изменение обработчика событий

Обработчик событий звучит сложно, но это просто другое имя кода, вызываемого при возникновении события. В этом случае добавляется действие, которое запускается нажатием кнопки "Hello World!".

1. В обозревателе решенийдважды щелкните страницу кода MainWindow.xaml.cs.

2. Измените код обработчика событий в открываемом окне редактора C#.

   Вот где все интересно. Обработчик событий по умолчанию выглядит следующим образом:

   

   Давайте изменим его, так что выглядит следующим образом:

   

   Ниже приведен код для копирования и вставки:

   private async void myButton_Click(object sender, RoutedEventArgs e)
   {
       var welcomeDialog = new ContentDialog()
       {
           Title = "Hello from HelloWorld",
           Content = "Welcome to your first Windows App SDK app.",
           CloseButtonText = "Ok",
           XamlRoot = myButton.XamlRoot
       };
       await welcomeDialog.ShowAsync();
   }
   

Что мы только что сделали?

Код использует элемент управления ContentDialog для отображения приветственного сообщения в модальном всплывающем элементе управления в текущем окне. (Дополнительные сведения об использовании Microsoft.UI.Xaml.Controls.ContentDialogсм. в классе ContentDialog.)

Запуск приложения

Пришло время создать, развернуть и запустить приложение Windows App SDK "Hello World", чтобы увидеть, как оно выглядит. Вот как.

1. Нажмите кнопку воспроизведения (текст HelloWorld (пакет)), чтобы запустить приложение на локальном компьютере.

   

   (Кроме того, можно выбрать Отладка>Начать отладку в строке меню или нажать F5, чтобы запустить приложение.)

2. Откройте своё приложение, которое появится сразу после исчезновения заставки. Приложение должно выглядеть примерно так:

   

3. Нажмите кнопку Hello World.

   На устройстве с Windows 10 или более поздней версии появится сообщение с надписью "Добро пожаловать в свое первое приложение пакета SDK для приложений Для Windows" с названием Hello from HelloWorld. Нажмите кнопку ОК, чтобы закрыть сообщение.

   

4. Чтобы закрыть приложение, нажмите кнопку Остановить отладку на панели инструментов. (Кроме того, выберите Отладка>Остановить отладку из строки меню или нажмите клавиши Shift+F5.)

Дальнейшие действия

Поздравляем с завершением работы с этим руководством! Мы надеемся, что вы узнали некоторые основы о пакете SDK для приложений Windows, WinUI 3 и интегрированной среде разработки Visual Studio. Дополнительные сведения см. в следующем руководстве:

См. также

• Написание приложений для Windows: выбор технологии разработки
• Обзор пакета SDK для приложений Windows
• пакет SDK для приложений Windows / примеры WinUI 3