Создание приложения Windows Forms на C# в Visual Studio Create a Windows Forms app in Visual Studio with C#

В рамках этого краткого знакомства с возможностями интегрированной среды разработки Visual Studio (IDE) вы создадите простое приложение на C# с пользовательским интерфейсом на основе Windows. In this short introduction to the Visual Studio integrated development environment (IDE), you’ll create a simple C# application that has a Windows-based user interface (UI).

Установите Visual Studio бесплатно со страницы скачиваемых материалов Visual Studio, если еще не сделали этого. If you haven’t already installed Visual Studio, go to the Visual Studio downloads page to install it for free.

Установите Visual Studio бесплатно со страницы скачиваемых материалов Visual Studio, если еще не сделали этого. If you haven’t already installed Visual Studio, go to the Visual Studio downloads page to install it for free.

На некоторых снимках экрана в этом учебнике используется темная тема. Some of the screenshots in this tutorial use the dark theme. Если вы не используете темную тему, но хотите переключиться на нее, см. страницу Персонализация интегрированной среды разработки и редактора Visual Studio. If you aren’t using the dark theme but would like to, see the Personalize the Visual Studio IDE and Editor page to learn how.

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

Сначала вы создадите проект приложения на C#. First, you’ll create a C# application project. Для этого типа проекта уже имеются все нужные файлы шаблонов, что избавляет вас от лишней работы. The project type comes with all the template files you’ll need, before you’ve even added anything.

Откройте Visual Studio 2017. Open Visual Studio 2017.

В верхней строке меню последовательно выберите Файл > Создать > Проект. From the top menu bar, choose File > New > Project.

В левой области диалогового окна Новый проект разверните узел Visual C# и выберите Рабочий стол Windows. In the New Project dialog box in the left pane, expand Visual C#, and then choose Windows Desktop. На средней панели выберите Приложение Windows Forms (.NET Framework) . In the middle pane, choose Windows Forms App (.NET Framework). Назовите файл HelloWorld . Then name the file HelloWorld .

Если шаблон проекта Приложение Windows Forms (.NET Framework) отсутствует, закройте диалоговое окно Новый проект и в верхней строке меню выберите Сервис > Получить средства и компоненты. If you don’t see the Windows Forms App (.NET Framework) project template, cancel out of the New Project dialog box and from the top menu bar, choose Tools > Get Tools and Features. Запускается Visual Studio Installer. The Visual Studio Installer launches. Выберите рабочую нагрузку .Разработка классических приложений .NET и затем элемент Изменить. Choose the .NET desktop development workload, then choose Modify.

Запустите Visual Studio 2019. Open Visual Studio 2019.

На начальном экране выберите Создать проект. On the start window, choose Create a new project.

В окне Создать проект выберите шаблон Приложение Windows Forms (.NET Framework) для C#. On the Create a new project window, choose the Windows Forms App (.NET Framework) template for C#.

(При желании вы можете уточнить условия поиска, чтобы быстро перейти к нужному шаблону. (If you prefer, you can refine your search to quickly get to the template you want. Например, введите Приложение Windows Forms в поле поиска. For example, enter or type Windows Forms App in the search box. Затем выберите C# в списке языков и Windows в списке платформ.) Next, choose C# from the Language list, and then choose Windows from the Platform list.)

Если шаблон Приложение Windows Forms (.NET Framework) отсутствует, его можно установить из окна Создание проекта. If you do not see the Windows Forms App (.NET Framework) template, you can install it from the Create a new project window. В сообщении Не нашли то, что искали? выберите ссылку Установка других средств и компонентов. In the Not finding what you’re looking for? message, choose the Install more tools and features link.

После этого в Visual Studio Installer выберите рабочую нагрузку Разработка классических приложений .NET. Next, in the Visual Studio Installer, choose the Choose the .NET desktop development workload.

Затем нажмите кнопку Изменить в Visual Studio Installer. After that, choose the Modify button in the Visual Studio Installer. Вам может быть предложено сохранить результаты работы; в таком случае сделайте это. You might be prompted to save your work; if so, do so. Выберите Продолжить, чтобы установить рабочую нагрузку. Next, choose Continue to install the workload. После этого вернитесь к шагу 2 в процедуре Создание проекта. Then, return to step 2 in this «Create a project» procedure.

В поле Имя проекта окна Настроить новый проект введите HelloWorld. In the Configure your new project window, type or enter HelloWorld in the Project name box. Затем нажмите Создать. Then, choose Create.

Новый проект открывается в Visual Studio. Visual Studio opens your new project.

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

Когда вы выберете шаблон проекта C# и зададите имя файла, Visual Studio открывает форму. After you select your C# project template and name your file, Visual Studio opens a form for you. Форма является пользовательским интерфейсом Windows. A form is a Windows user interface. Мы создадим приложение Hello World, добавив элементы управления на форму, а затем запустим его. We’ll create a «Hello World» application by adding controls to the form, and then we’ll run the app.

Добавление кнопки на форму Add a button to the form

Щелкните Панель элементов, чтобы открыть всплывающее окно «Панель элементов». Choose Toolbox to open the Toolbox fly-out window.

(Если параметр для всплывающего окна Панель элементов отсутствует, его можно открыть в строке меню. (If you don’t see the Toolbox fly-out option, you can open it from the menu bar. Для этого выберите Вид > Панель элементов. To do so, View > Toolbox. Либо нажмите клавиши CTRL+ALT+X.) Or, press Ctrl+Alt+X.)

Щелкните значок Закрепить, чтобы закрепить окно Панель элементов. Choose the Pin icon to dock the Toolbox window.

Выберите элемент управления Кнопка и перетащите его на форму. Choose the Button control and then drag it onto the form.

В окне Свойства найдите элемент Текст, измените имя с Button1 на Click this , а затем нажмите клавишу ВВОД. In the Properties window, locate Text, change the name from Button1 to Click this , and then press Enter.

(Если окно Свойства не отображается, его можно открыть в строке меню.) (If you don’t see the Properties window, you can open it from the menu bar. Для этого выберите Вид > Окно свойств. To do so, choose View > Properties Window. Или нажмите клавишу F4.) Or, press F4.)

В разделе Проектирование окна Свойства измените имя с Button1 на btnClickThis , а затем нажмите клавишу ВВОД. In the Design section of the Properties window, change the name from Button1 to btnClickThis , and then press Enter.

Если список был упорядочен по алфавиту в окне Свойства, Button1 появится в разделе (DataBindings) . If you’ve alphabetized the list in the Properties window, Button1 appears in the (DataBindings) section, instead.

Добавление метки на форму Add a label to the form

Теперь, когда мы добавили элемент управления »Кнопка» для создания действия, давайте добавим элемент управления «Метка», куда можно отправлять текст. Now that we’ve added a button control to create an action, let’s add a label control to send text to.

Выберите элемент управления Метка в окне Панель элементов, а затем перетащите его на форму и расположите под кнопкой Нажмите это. Select the Label control from the Toolbox window, and then drag it onto the form and drop it beneath the Click this button.

В разделе Проект или (DataBindings) окна Свойства измените имя Label1 на lblHelloWorld и нажмите клавишу ВВОД. In either the Design section or the (DataBindings) section of the Properties window, change the name of Label1 to lblHelloWorld , and then press Enter.

Добавление кода на форму Add code to the form

В окне Form1.cs [Проект] дважды щелкните кнопку Нажмите это, чтобы открыть окно Form1.cs. In the Form1.cs [Design] window, double-click the Click this button to open the Form1.cs window.

(Кроме того, можно развернуть узел Form1.cs в обозревателе решений, а затем выбрать Form1.) (Alternatively, you can expand Form1.cs in Solution Explorer, and then choose Form1.)

В окне Form1.cs после строки private void введите lblHelloWorld.Text = «Hello World!»; , как показано на следующем снимке экрана: In the Form1.cs window, after the private void line, type or enter lblHelloWorld.Text = «Hello World!»; as shown in the following screenshot:

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

Нажмите кнопку Запустить, чтобы запустить приложение. Choose the Start button to run the application.

Будет выполнено несколько операций. Several things will happen. В интегрированной среде разработки Visual Studio откроются окна Средства диагностики и Вывод. In the Visual Studio IDE, the Diagnostics Tools window will open, and an Output window will open, too. Кроме того, вне этой среды откроется диалоговое окно Form1. But outside of the IDE, a Form1 dialog box appears. Оно будет содержать вашу кнопку Нажмите это и текст Label1. It will include your Click this button and text that says Label1.

Нажмите кнопку Нажмите это в диалоговом окне Form1. Choose the Click this button in the Form1 dialog box. Обратите внимание, что текст Label1 меняется на Hello World! . Notice that the Label1 text changes to Hello World!.

Закройте диалоговое окно Form1, чтобы завершить работу приложения. Close the Form1 dialog box to stop running the app.

Следующие шаги Next steps

Для получения дополнительных сведений перейдите к следующему руководству: To learn more, continue with the following tutorial:

Пошаговое руководство. Сборка приложения Walkthrough: Build an application

Выполнив это пошаговое руководство, вы ознакомитесь с несколькими параметрами, которые можно настроить при создании приложений с помощью Visual Studio. By completing this walkthrough, you’ll become more familiar with several options that you can configure when you build applications with Visual Studio. Вы создадите настраиваемую конфигурацию сборки, скроете определенные предупреждения и расширите выходные данные сборки для примера приложения. You’ll create a custom build configuration, hide certain warning messages, and increase build output information for a sample application.

Установите пример приложения Install the sample application

Скачайте пример Общие сведения о сборке приложений WPF. Download the Introduction to building WPF applications sample. Выберите язык C# или Visual Basic. Choose either C# or Visual Basic. После загрузки файла .zip извлеките его содержимое и откройте файл ExpenseItIntro.sln с помощью Visual Studio. After the .zip file has downloaded, extract it and open the ExpenseItIntro.sln file using Visual Studio.

Создание настраиваемой конфигурации сборки Create a custom build configuration

При создании решения конфигурации отладочной сборки и сборки выпуска и их целевые платформы по умолчанию определяются для решения автоматически. When you create a solution, debug and release build configurations and their default platform targets are defined for the solution automatically. Затем вы можете настроить эти конфигурации или создать собственные. You can then customize these configurations or create your own. Конфигурации указывают тип сборки. Build configurations specify the build type. Целевые платформы указывают операционную систему, на которое ориентировано приложение для этой конфигурации. Build platforms specify the operating system that an application targets for that configuration. См. дополнительные сведения о конфигурациях сборки, платформах сборки и конфигурациях отладки и выпуска проекта. For more information, see Understand build configurations, Understand build platforms, and How to: Set debug and release configurations.

Конфигурации и параметры платформы можно изменять или создавать с помощью диалогового окна Диспетчер конфигураций. You can change or create configurations and platform settings by using the Configuration Manager dialog box. В этой процедуре вы создадите конфигурацию сборки для тестирования. In this procedure, you’ll create a build configuration for testing.

Создание конфигурации сборки Create a build configuration

Откройте диалоговое окно Диспетчер конфигураций. Open the Configuration Manager dialog box.

В списке Активная конфигурация решения выберите . In the Active solution configuration list, choose .

В диалоговом окне Создание конфигурации решения введите для новой конфигурации имя Test , скопируйте параметры из существующей конфигурации Отладка и нажмите кнопку ОК. In the New Solution Configuration dialog box, name the new configuration Test , copy settings from the existing Debug configuration, and then choose the OK button.

В списке Активная платформа решения выберите . In the Active solution platform list, choose .

В диалоговом окне Создание платформы решения выберите x64 и не копируйте параметры из платформы x86. In the New Solution Platform dialog box, choose x64, and don’t copy settings from the x86 platform.

Нажмите кнопку ОК . Choose the OK button.

Активная конфигурация решения была изменена на Тест, а для активной платформы решения задано значение x64. The active solution configuration has been changed to Test with the active solution platform set to x64.

Нажмите кнопку Закрыть. Choose Close.

Активную конфигурацию решения можно быстро проверить или изменить с помощью списка Конфигурации решения на панели инструментов Стандартная. You can quickly verify or change the active solution configuration by using the Solution Configurations list on the Standard toolbar.

создание приложения; Build the application

Далее вам предстоит создать решение с помощью настраиваемой конфигурации сборки. Next, you’ll build the solution with the custom build configuration.

Выполните сборку решения. Build the solution

В строке меню последовательно выберите Сборка > Собрать решение (или нажмите CTRL+SHIFT+B). On the menu bar, choose Build > Build Solution, or press Ctrl+Shift+B.

Окно Вывод отображает результат сборки. The Output window displays the results of the build. Сборка успешно завершена. The build succeeded.

Скрытие предупреждений компилятора Hide compiler warnings

Далее мы добавим код, который приводит к созданию предупреждения компилятором. Next we’ll introduce some code that causes a warning to be generated by the compiler.

В проекте C# откройте файл ExpenseReportPage.xaml.cs. In the C# project, open the ExpenseReportPage.xaml.cs file. В методе ExpenseReportPage добавьте следующий код: int i; . In the ExpenseReportPage method, add the following code: int i; .

В проекте Visual Basic откройте файл ExpenseReportPage.xaml.vb. In the Visual Basic project, open the ExpenseReportPage.xaml.vb file. В пользовательском конструкторе Public Sub New. добавьте следующий код: Dim i . In the custom constructor Public Sub New. , add the following code: Dim i .

Создайте решение. Build the solution.

Окно Вывод отображает результат сборки. The Output window displays the results of the build. Сборка была выполнена успешно, но были созданы предупреждения: The build succeeded, but warnings were generated:

Вы можете временно скрыть некоторые предупреждения во время сборки, чтобы они не засоряли выходные данные сборки. You can temporarily hide certain warning messages during a build rather than have them clutter up the build output.

Скрытие определенного предупреждения C# Hide a specific C# warning

В обозревателе решений выберите узел проекта верхнего уровня. In Solution Explorer, choose the top-level project node.

В строке меню выберите Вид > Страницы свойств. On the menu bar, choose View > Property Pages.

Открывается Конструктор проектов. The Project Designer opens.

Выберите страницу Сборка и затем в поле Отключить предупреждения укажите номер предупреждения 0168. Choose the Build page and then, in the Suppress warnings box, specify the warning number 0168.

Создайте решение. Build the solution.

Окно Вывод отображает только сводные данные о сборке. The Output window displays only summary information for the build.

Отключение всех предупреждений сборки в Visual Basic Suppress all Visual Basic build warnings

В обозревателе решений выберите узел проекта верхнего уровня. In Solution Explorer, choose the top-level project node.

В строке меню выберите Вид > Страницы свойств. On the menu bar, choose View > Property Pages.

Открывается Конструктор проектов. The Project Designer opens.

На странице Компиляция установите флажок Выключить все предупреждения. On the Compile page, select the Disable all warnings check box.

Создайте решение. Build the solution.

Окно Вывод отображает только сводные данные о сборке. The Output window displays only summary information for the build.

Отображение дополнительных сведений о сборке в окне вывода Display additional build details in the Output window

Вы можете изменить объем информации, отображаемый о процессе сборки в окне Вывод. You can change how much information about the build process appears in the Output window. В общем случае задан минимальный уровень детализации сборки, при котором в окне Вывод отображается только сводка по процессу сборки вместе с высокоприоритетными предупреждениями или ошибками. Build verbosity is usually set to Minimal, which means that the Output window displays only a summary of the build process along with any high priority warnings or errors. Чтобы отобразить дополнительные сведения о сборке, см. раздел Диалоговое окно «Параметры», «Проекты и решения», «Сборка и запуск». You can display more information about the build by using the Options dialog box, Projects and Solutions, Build and Run.

При отображении дополнительных сведений сборка будет занимать больше времени. If you display more information, the build will take longer to complete.

Изменение объема сведений в окне вывода Change the amount of information in the Output window

Откройте диалоговое окно Параметры. Open the Options dialog box.

Выберите категорию Проекты и решения и затем страницу Сборка и запуск. Choose the Projects and Solutions category, and then choose the Build and Run page.

В списке Степень подробности сообщений при сборке проекта MSBuild выберите значение Обычная и нажмите кнопку ОК. In the MSBuild project build output verbosity list, choose Normal, and then choose the OK button.

В строке меню выберите Сборка > Очистить решение. On the menu bar, choose Build > Clean Solution.

Выполните сборку решения и просмотрите сведения в окне Вывод. Build the solution, and then review the information in the Output window.

Сведения о сборке включают в себя время запуска сборки (находится в начале) и порядок обработки файлов. The build information includes the time that the build started (located at the beginning) and the order in which files were processed. Они также включают фактический синтаксис компилятора, запускаемый Visual Studio при сборке. This information also includes the actual compiler syntax that Visual Studio runs during the build.

Например, параметр /nowarn в сборке C# выводит указанный вами ранее код предупреждения 0168, а также три других предупреждения. For example, in the C# build, the /nowarn option lists the warning code, 0168, that you specified earlier in this topic, along with three other warnings.

В сборке Visual Basic параметр /nowarn не включает в себя определенные исключаемые предупреждения, поэтому предупреждения не отображаются. In the Visual Basic build, /nowarn doesn’t include specific warnings to exclude, so no warnings appear.

В окне Вывод можно искать содержимое, отобразив диалоговое окно Найти нажатием клавиш CTRL+F. You can search the contents of the Output window if you display the Find dialog box by choosing the Ctrl+F keys.

Создание сборки выпуска Create a Release Build

Вы можете создать версию примера приложения, оптимизированную для поставки. You can build a version of the sample application that’s optimized for shipping it. Для сборки выпуска вы указываете, что исполняемый файл копируется в общую сетевую папку перед запуском сборки. For the release build, you’ll specify that the executable is copied to a network share before the build is kicked off.

Указание сборки выпуска для Visual Basic Specify a release build for Visual Basic

Открывается Конструктор проектов. Open the Project Designer.

Откройте вкладку Компиляция. Choose the Compile page.

В списке Конфигурация выберите Выпуск. In the Configuration list, choose Release.

В списке Платформа выберите x86. In the Platform list, choose x86.

В поле Выходной путь сборки укажите сетевой путь. In the Build output path box, specify a network path.

Например, так: \\myserver\builds . For example, you can specify \\myserver\builds .

Может появиться окно с предупреждением о том, что указанная вами сетевая общая папка может быть ненадежна. A message box might appear, warning you that the network share that you’ve specified might not be a trusted location. Если вы доверяете указанному расположению, нажмите кнопку ОК в окне сообщения. If you trust the location that you’ve specified, choose the OK button in the message box.

Создайте приложение. Build the application.

Указание сборки выпуска для C# Specify a release build for C#

Открывается Конструктор проектов. Open the Project Designer.

Перейдите на страницу Сборка. Choose the Build page.

В списке Конфигурация выберите Выпуск. In the Configuration list, choose Release.

В списке Платформа выберите x86. In the Platform list, choose x86.

В поле Путь для создаваемых файлов укажите сетевой путь. In the Output path box, specify a network path.

Например, можно указать \\myserver\builds . For example, you could specify \\myserver\builds .

Может появиться окно с предупреждением о том, что указанная вами сетевая общая папка может быть ненадежна. A message box might appear, warning you that the network share that you’ve specified might not be a trusted location. Если вы доверяете указанному расположению, нажмите кнопку ОК в окне сообщения. If you trust the location that you’ve specified, choose the OK button in the message box.

На стандартной панели инструментов выберите в качестве конфигураций решения Выпуск, а в качестве платформ решения — x86. On the Standard toolbar, set the Solution Configurations to Release and the Solution Platforms to x86.

Создайте приложение. Build the application.

Исполняемый файл копируется в указанный сетевой путь. The executable file is copied to the network path that you specified. Путем к нему будет \\myserver\builds\\FileName.exe . Its path would be \\myserver\builds\\FileName.exe .

Поздравляем! Congratulations! Вы успешно выполнили это пошаговое руководство. You’ve successfully completed this walkthrough.