Создание приложения Windows Forms на C# в Visual Studio
Область применения:
Visual Studio Visual Studio для Mac 
Visual Studio Code
В этом руководстве вы создадите простое приложение C# с пользовательским интерфейсом на основе Windows.
Установите Visual Studio бесплатно со страницы скачиваемых материалов Visual Studio, если еще не сделали этого.
На некоторых снимках экрана в этом учебнике используется темная тема. Если вы не используете темную тему, но хотите переключиться на нее, см. страницу Персонализация интегрированной среды разработки и редактора Visual Studio.
Установите Visual Studio бесплатно со страницы скачиваемых материалов Visual Studio 2022, если еще не сделали этого.
Создание проекта
Сначала вы создадите проект приложения на C#. Для этого типа проекта уже имеются все нужные файлы шаблонов, что избавляет вас от лишней работы.
- Откройте Visual Studio.
- На начальном экране выберите Создать проект.
- В окне Создать проект выберите шаблон Приложение Windows Forms (.NET Framework) для C#. (Если вы предпочитаете, вы можете уточнить поиск, чтобы быстро получить нужный шаблон. Например, введите или введите приложение Windows Forms в поле поиска. Затем выберите C# в списке языков и выберите Windows в списке платформ.)
Примечание. Если шаблон Приложение Windows Forms (.NET Framework) отсутствует, его можно установить из окна Создание проекта. В сообщении Не нашли то, что искали? выберите ссылку Установка других средств и компонентов. 
После этого в Visual Studio Installer выберите рабочую нагрузку Разработка классических приложений .NET. 
Затем нажмите кнопку Изменить в Visual Studio Installer. Вам может быть предложено сохранить результаты работы; в таком случае сделайте это. Выберите Продолжить, чтобы установить рабочую нагрузку. После этого вернитесь к шагу 2 в процедуре Создание проекта.
- Откройте Visual Studio.
- В окне запуска выберите Создание нового проекта.
- В окне Создание проекта выберите шаблон Приложение Windows Forms (.NET Framework) для C#. (Если вы предпочитаете, вы можете уточнить поиск, чтобы быстро получить нужный шаблон. Например, введите или введите приложение Windows Forms в поле поиска. Затем выберите C# в списке языков , а затем выберите Windows в списке платформ .)
Примечание. Если шаблон Приложение Windows Forms (.NET Framework) отсутствует, его можно установить из окна Создание проекта. В сообщении Не нашли то, что искали? выберите ссылку Установка других средств и компонентов. После этого выберите рабочую нагрузку Разработка классических приложений .NET в Visual Studio Installer. 
Затем нажмите кнопку Изменить в Visual Studio Installer. Вам может быть предложено сохранить результаты работы; в таком случае сделайте это. Выберите Продолжить, чтобы установить рабочую нагрузку. После этого вернитесь к шагу 2 в процедуре Создание проекта.
Создание приложения
Когда вы выберете шаблон проекта C# и зададите имя файла, Visual Studio открывает форму. Форма является пользовательским интерфейсом Windows. Мы создадим приложение Hello World, добавив элементы управления на форму, а затем запустим его.
Добавление кнопки на форму
- Выберите Панель элементов, чтобы открыть всплывающее окно «Панель элементов».
(Если вы не видите Флажок всплывающего меню панели элементов можно открыть в строке меню. Для этого просмотрите >панель элементов. Или нажмите клавиши CTRL+ALT+X.) - Разверните общие элементы управления и выберите значок «Закрепить«, чтобы закрепить окно панели элементов.
- Выберите элемент управления Кнопка и перетащите его на форму.
- В окне Свойства найдите Текст, измените имя с button1 на Click this и нажмите клавишу ВВОД.
(Если вы не видите Окно свойств можно открыть в строке меню. Для этого выберите окно «Просмотр>свойств». Или нажмите клавишу F4.) - В разделе Конструктор окна Свойства измените имя с button1 на btnClickThis и нажмите клавишу ВВОД.
Примечание. Если список в окне Свойства был упорядочен по алфавиту, button1 появится в разделе Привязки данных.
Добавление метки на форму
Теперь, когда мы добавили элемент управления »Кнопка» для создания действия, давайте добавим элемент управления «Метка», куда можно отправлять текст.
- Выберите элемент управления Метка в окне Панель элементов, а затем перетащите его на форму и расположите под кнопкой Нажмите это.
- В разделе Конструктор или Привязки данных окна Свойства измените имя label1 на lblHelloWorld и нажмите клавишу ВВОД.
Добавление кода на форму
- В окне Form1.cs [Конструктор] дважды щелкните эту кнопку, чтобы открыть окно Form1.cs. (Кроме того, можно развернуть узел Form1.cs в обозревателе решений, а затем выбрать Form1.)
- В окне Form1.cs после строки private void введите lblHelloWorld.Text = «Hello World!»; , как показано на следующем снимке экрана:
Выполнение приложения
- Нажмите кнопку Запустить, чтобы запустить приложение.
Будет выполнено несколько операций. В интегрированной среде разработки Visual Studio откроются окна Средства диагностики и Вывод. Кроме того, вне этой среды откроется диалоговое окно Form1. Оно будет содержать вашу кнопку Нажмите это и текст label1. - Нажмите кнопку Нажмите это в диалоговом окне Form1. Обратите внимание, что текст label1 меняется на Hello World!.
- Закройте диалоговое окно Form1, чтобы завершить работу приложения.
Создание приложения
Когда вы выберете шаблон проекта C# и зададите имя файла, Visual Studio открывает форму. Форма является пользовательским интерфейсом Windows. Мы создадим приложение Hello World, добавив элементы управления на форму, а затем запустим его.
Добавление кнопки на форму
- Щелкните Панель элементов, чтобы открыть всплывающее окно «Панель элементов».
(Если вы не видите Флажок всплывающего меню панели элементов можно открыть в строке меню. Для этого просмотрите >панель элементов. Или нажмите клавиши CTRL+ALT+X.) - Щелкните значок Закрепить, чтобы закрепить окно Панель элементов.
- Выберите элемент управления Кнопка и перетащите его на форму.
- В окне Свойства найдите элементТекст, измените имя с Button1 на Click this , а затем нажмите клавишу ВВОД.
(Если вы не видите Окно свойств можно открыть в строке меню. Для этого выберите окно «Просмотр>свойств». Или нажмите клавишу F4.) - В разделе Проектирование окна Свойства измените имя с Button1 на btnClickThis , а затем нажмите клавишу ВВОД.
Примечание. Если список был упорядочен по алфавиту в окне Свойства, Button1 появится в разделе (DataBindings).
Добавление метки на форму
Теперь, когда мы добавили элемент управления »Кнопка» для создания действия, давайте добавим элемент управления «Метка», куда можно отправлять текст.
- Выберите элемент управления Метка в окне Панель элементов, а затем перетащите его на форму и расположите под кнопкой Нажмите это.
- В разделе Проект или (DataBindings) окна Свойства измените имя Label1 на lblHelloWorld и нажмите клавишу ВВОД.
Добавление кода на форму
- В окне Form1.cs [Конструктор] дважды щелкните эту кнопку, чтобы открыть окно Form1.cs. (Кроме того, можно развернуть Form1.cs в Обозреватель решений, а затем выберите команду View Code (или нажмите клавишу F7) в меню правой кнопкой мыши в Form1.cs.)
- В окне Form1.cs после строки private void введите lblHelloWorld.Text = «Hello World!»; , как показано на следующем снимке экрана:
Выполнение приложения
- Нажмите кнопку Запустить, чтобы запустить приложение.
Будет выполнено несколько операций. В интегрированной среде разработки Visual Studio откроются окна Средства диагностики и Вывод. Кроме того, вне этой среды откроется диалоговое окно Form1. Оно будет содержать вашу кнопку Нажмите это и текст Label1. - Нажмите кнопку Нажмите это в диалоговом окне Form1. Обратите внимание, что текст Label1 меняется на Hello World!.
- Закройте диалоговое окно Form1, чтобы завершить работу приложения.
Следующие шаги
Поздравляем с завершением этого учебника! Для получения дополнительных сведений перейдите к следующему руководству:
См. также
- Другие руководства по C#
- Руководства по Visual Basic
- Руководства по C++
Руководство. Создание приложения Windows Forms с помощью .NET
Из этого краткого руководства вы узнаете, как создать новое приложение Windows Forms с помощью Visual Studio. После создания первоначального приложения вы научитесь добавлять элементы управления и обрабатывать события. По завершении работы с этим руководством у вас будет простое приложение, добавляющее имена в список.
Документация по рабочему столу для .NET 7 и .NET 6 находится в стадии разработки.
В этом руководстве описано следующее:
- Создание приложения Windows Forms
- Добавление элементов управления на форму
- Обработка событий элемента управления для предоставления функциональных возможностей приложения
- Выполнить приложение
Необходимые компоненты
- Visual Studio 2022 версии 17.0 или более поздней.
- Выберите рабочую нагрузку Разработка классических приложений .NET.
- Выберите отдельный компонент .NET 6.
- Visual Studio 2022 версии 17.4 или более поздней версии
- Выберите рабочую нагрузку Разработка классических приложений .NET.
- Выберите отдельный компонент .NET 7
Используйте Visual Studio 2022 версии 17.4 или более поздней версии и установите отдельные компоненты .NET 7 и .NET 6. Добавлена поддержка .NET 7 в Visual Studio 2022 версии 17.4.
Создание приложения Windows Forms
Первым шагом в создании нового приложения является запуск Visual Studio и создание приложения на основе шаблона.
- Откройте Visual Studio.
- Выберите Создать новый проект.
- В поле Поиск шаблонов введите winforms и дождитесь появления результатов поиска.
- В раскрывающемся списке язык кода выберите C# или Visual Basic.
- В списке шаблонов выберите Приложение Windows Forms и щелкните Далее.
Важно! Не выбирайте шаблон Приложение Windows Forms (.NET Framework).
На следующем рисунке показаны шаблоны проектов как для C#, так и для Visual Basic .NET. Если применить фильтр языка кода, отображается соответствующий шаблон.
- В окне Настроить новый проект задайте в поле Имя проекта значение Names и щелкните Создать. Вы также можете сохранить проект в другую папку, изменив путь в поле Расположение.
- Наконец, на странице Дополнительные сведения выберите для параметра Платформа значение .NET 6.0 (долгосрочная поддержка) и нажмите кнопку Создать.
- Откройте Visual Studio.
- Выберите Создать новый проект.
- В поле Поиск шаблонов введите winforms и дождитесь появления результатов поиска.
- В раскрывающемся списке язык кода выберите C# или Visual Basic.
- В списке шаблонов выберите Приложение Windows Forms и щелкните Далее.
Важно! Не выбирайте шаблон Приложение Windows Forms (.NET Framework).
На следующем рисунке показаны шаблоны проектов как для C#, так и для Visual Basic .NET. Если применить фильтр языка кода, отображается соответствующий шаблон.
- В окне Настроить новый проект задайте в поле Имя проекта значение Names и щелкните Создать. Вы также можете сохранить проект в другую папку, изменив путь в поле Расположение.
- Наконец, в окне «Дополнительные сведения » выберите .NET 7.0 (стандартная поддержка терминов) для параметра Framework и нажмите кнопку «Создать«.
- Обозреватель решений Все файлы проекта, код, формы и ресурсы отображаются в этой области.
- Свойства На этой панели отображаются параметры свойств, которые можно настроить в зависимости от выбранного элемента. Например, если выбрать элемент в Обозревателе решений, отобразятся параметры свойств, связанные с файлом. Если выбрать объект в конструкторе, отобразятся параметры элемента управления или формы.
- Конструктор форм Это конструктор для формы. Он является интерактивным, и на него можно перетаскивать объекты из панели элементов. Выбирая и перемещая элементы в конструкторе, можно визуально создавать пользовательский интерфейс для приложения.
- Панель инструментов Панель элементов содержит все элементы управления, которые можно добавить на форму. Чтобы добавить элемент управления на текущую форму, дважды щелкните элемент управления или перетащите его.
- Label
- Кнопка
- Listbox
- текстовое поле;
- Выберите в форме элемент управления «Кнопка».
- В области Свойства щелкните значок события , чтобы вывести список событий кнопки.
- Найдите событие Click и дважды щелкните его, чтобы создать обработчик событий. Это действие добавляет следующий код в форму:
После создания приложения Visual Studio должен открыть панель конструктора для формы по умолчанию Form1. Если конструктор форм не отображается, дважды щелкните форму в области Обозреватель решений, чтобы открыть окно конструктора.
Важные элементы среды Visual Studio
Поддержка Windows Forms в Visual Studio состоит из четырех важных компонентов, с которыми вы будете взаимодействовать при создании приложения.
Если панель элементов не отображается, ее можно отобразить с помощью элемента меню «Вид >панели элементов».
Добавление элементов управления на форму
Открыв конструктор форм Form1, используйте панель Область элементов, чтобы добавить на форму следующие элементы управления:
Вы можете расположить и изменить размер элементов управления в соответствии со следующими настройками. Либо визуально перенесите их, чтобы они соответствовали следующему снимку экрана, либо щелкните каждый элемент управления и настройте параметры в области Свойства. Можно также щелкнуть область заголовка формы, чтобы выбрать форму.
| Объект | Параметр | Значение |
|---|---|---|
| Форма | Текст | Names |
| Size | 268, 180 | |
| Подпись | Местонахождение | 12, 9 |
| Текст | Names | |
| Listbox | Имя | lstNames |
| Местонахождение | 12, 27 | |
| Size | 120, 94 | |
| текстовое поле; | Имя | txtName |
| Местонахождение | 138, 26 | |
| Size | 100, 23 | |
| Кнопка | Имя | btnAdd |
| Местонахождение | 138, 55 | |
| Size | 100, 23 | |
| Текст | Add Name |
Вы должны получить в конструкторе форму, которая выглядит следующим образом.
Обработка событий
Теперь, когда в форме есть все элементы управления, необходимо обрабатывать события элементов управления, чтобы реагировать на вводимые пользователем данные. Открыв конструктор форм, выполните следующие действия.
private void btnAdd_Click(object sender, EventArgs e)
Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click End Sub private void btnAdd_Click(object sender, EventArgs e)
Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click If Not String.IsNullOrWhiteSpace(txtName.Text) And Not lstNames.Items.Contains(txtName.Text) Then lstNames.Items.Add(txtName.Text) End If End Sub Выполнить приложение
Теперь, когда у нас есть код события, можно запустить приложение, нажав клавишу F5 или выбрав пункт меню Отладка>Начать отладку. Отобразится форма, и вы можете ввести имя в текстовое поле, а затем добавить его, нажав кнопку.
Учебник. Создание приложения WinForms на Visual Basic
Область применения:Visual Studio Visual Studio для Mac Visual Studio Code
В этом учебнике вы создадите приложение Visual Basic с пользовательским интерфейсом Windows Forms. Интегрированная среда разработки Visual Studio содержит все средства, необходимые для создания приложения Windows Forms.
В этом руководстве описано следующее:
- Создание проекта
- Добавление кнопки на форму
- Добавление метки и кода
- Выполнение приложения
Необходимые компоненты
Для выполнения шагов, описанных в этом учебнике, вам понадобится Visual Studio. Перейдите на страницу загрузки Visual Studio, чтобы получить бесплатную версию.
Для выполнения шагов, описанных в этом учебнике, вам понадобится Visual Studio. Перейдите на страницу загрузки Visual Studio, чтобы получить бесплатную версию.
Создание проекта
Создайте проект приложения Visual Basic. Для этого типа проекта уже имеются все нужные файлы шаблонов, что избавляет вас от лишней работы.
- Откройте Visual Studio.
- На начальном экране выберите Создать проект.
- В окне Создать проект выберите шаблон Приложение Windows Forms (.NET Framework) для Visual Basic. Вы можете уточнить условия поиска, чтобы быстро перейти к нужному шаблону. Например, введите Приложение Windows Forms в поле поиска. Затем выберите Visual Basic в списке языков и Windows в списке платформ.
Примечание. Если шаблон Приложение Windows Forms (.NET Framework) отсутствует, его можно установить из окна Создание проекта. В сообщении Не нашли то, что искали? выберите ссылку Установка других средств и компонентов. После этого в Visual Studio Installer выберите рабочую нагрузку Разработка классических приложений .NET. После этого в Visual Studio Installer выберите Изменить. Вам может быть предложено сохранить результаты работы.
- Откройте Visual Studio.
- На начальном экране выберите Создать проект.
- В окне Создать проект выберите шаблон Приложение Windows Forms (.NET Framework) для Visual Basic. Вы можете уточнить условия поиска, чтобы быстро перейти к нужному шаблону. Например, введите Приложение Windows Forms в поле поиска. Затем выберите Visual Basic в списке языков и Windows в списке платформ.
Примечание. Если шаблон Приложение Windows Forms (.NET Framework) отсутствует, его можно установить из окна Создание проекта. В сообщении Не нашли то, что искали? выберите ссылку Установка других средств и компонентов. После этого в Visual Studio Installer выберите рабочую нагрузку Разработка классических приложений .NET. После этого в Visual Studio Installer выберите Изменить. Вам может быть предложено сохранить результаты работы.
Добавление кнопки на форму
Когда вы выберете шаблон проекта Visual Basic и зададите имя файла, Visual Studio открывает форму. Форма является пользовательским интерфейсом Windows. Вы создадите приложение Hello World, добавив в форму элементы управления.
- В левой части интегрированной среды разработки Visual Studio выберите вкладку Панель элементов. Если вы ее не видите, выберите пункт Представление>Панель элементов в строке меню или воспользуйтесь комбинацией клавиш CTRL+ALT+X.
Если нужно, выберите значок Закрепить, чтобы закрепить окно Панель элементов. - Выберите элемент управления Кнопка и перетащите его на форму.
- В разделе Внешний вид окна Свойства введите для свойства TextНажать это и нажмите клавишу Ввод.
Если окно Свойства не отображается, его можно открыть в строке меню. Для этого выберите Вид>Окно свойств или нажмите клавишу F4. - В разделе Проектирование окна Свойства измените имя с Button1 на btnClickThis, а затем нажмите клавишу Ввод.
Примечание. Если список был упорядочен по алфавиту в окне Свойства, Button1 появится в разделе (DataBindings).
Добавление метки и кода
Теперь, когда мы добавили элемент управления »Кнопка» для создания действия, добавьте элемент управления «Метка», куда можно отправлять текст.
- Выберите элемент управления Метка в окне Панель элементов, а затем перетащите его на форму. Поместите его под кнопкой Нажать это.
- В разделе Проект или (DataBindings) окна Свойства измените имя Label1 на lblHelloWorld и нажмите клавишу Enter.
- В окне Form1.vb [Конструктор] дважды щелкните эту кнопку, чтобы открыть окно Form1.vb. Кроме того, можно развернуть узел Form1.vb в Обозревателе решений, а затем выбрать Form1.
- В окне Form1.vb между частными вложенными и конечными вложенными строками введите lblHelloWorld.Text = «Hello World!» как показано на следующем снимке экрана:
Выполнение приложения
Приложение готово к сборке и запуску.
- Выберите Пуск, чтобы запустить приложение.
В данном случае происходит следующее. В интегрированной среде разработки Visual Studio откроются окна Средства диагностики и Вывод. Вне этой среды откроется диалоговое окно Form1. Оно будет содержать вашу кнопку Нажать это и текст Label1. - Нажмите кнопку Нажмите это в диалоговом окне Form1.
Текст Label1 меняется на Hello World!. - Закройте диалоговое окно Form1, чтобы завершить работу приложения.
Следующие шаги
Чтобы узнать больше о Windows Forms, перейдите к следующему учебнику:
См. также
- Другие руководства по Visual Basic
- Руководства по C#
- Руководства по C++
Как добавить форму в проект (Windows Forms .NET)
Добавьте формы в свой проект с помощью Visual Studio. Если в приложении несколько форм, вы сможете выбрать начальную форму для приложения или одновременно отобразить несколько форм.
Документация по рабочему столу для .NET 7 и .NET 6 находится в стадии разработки.
Добавление новой формы
Добавьте новую форму в Visual Studio.
- В Visual Studio найдите панель Обозреватель проектов. Щелкните проект правой кнопкой мыши и выберите Добавить>Форма (Windows Forms).
- В поле Имя введите имя формы, например MyNewForm. Visual Studio сформирует имя по умолчанию, которое является уникальным. Можно использовать это имя.
После добавления формы Visual Studio откроет конструктор форм для этой формы.
Добавление ссылки на проект в форму
Если у вас есть исходные файлы для формы, можно добавить форму в проект, скопировав файлы в папку проекта. Ссылки на все файлы кода в папке проекта и в дочерних папках проекта будут автоматически добавлены в проект.
Форма включает два файла с одинаковыми именами и разными расширениями: form2.cs (form2 — пример имени файла) и form2.Designer.cs. Иногда присутствует файл ресурсов с тем же именем — form2.resx. В предыдущем примере form2 представляет собой базовое имя файла. Необходимо скопировать все связанные файлы в папку проекта.
Кроме того, можно использовать Visual Studio для импорта файла в проект. При добавлении существующего файла в проект файл копируется в папку проекта.
- В Visual Studio найдите панель Обозреватель проектов. Щелкните проект правой кнопкой мыши и выберите Добавить>Существующий элемент.
- Перейдите в папку, содержащую файлы формы.
- Выберите файл form2.cs, где form2 — базовое имя файла для связанных файлов формы. Не выбирайте другие файлы, например form2.Designer.cs.
См. также
- Как расположить форму и изменить ее размер (Windows Forms .NET)
- Общие сведения о событиях (Windows Forms .NET)
- Размещение и компоновка элементов управления (Windows Forms .NET)
Совместная работа с нами на GitHub
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.