Шаблоны проектов и элементов Project and item templates

Шаблоны проектов и элементов предоставляют многократно используемые заглушки, обеспечивающие пользователям определенный базовый код, и структуры, которые можно использовать в своих целях. Project and item templates provide reusable stubs that give users some basic code and structure, that they can customize for their own purposes.

шаблоны Visual Studio Visual Studio templates

При установке Visual Studio устанавливается ряд предопределенных шаблонов проектов и элементов. A number of predefined project and item templates are installed with Visual Studio. Эти шаблоны, такие как Веб-приложение ASP.NET и Библиотека классов, доступны для выбора при создании проекта. These templates, such as the ASP.NET Web Application and Class Library templates, are available to choose from when you create a new project. Шаблоны элементов, такие как файлы кода, XML-файлы, HTML-страницы и таблицы стилей, отображаются в диалоговом окне Добавление нового элемента. Item templates, such as code files, XML files, HTML pages, and Style Sheets, appear in the Add New Item window.

Для пользователей эти шаблоны представляют собой отправную точку, с которой можно начать создание новых проектов или расширение текущих проектов. These templates provide a starting point for users to begin creating projects, or to expand existing projects. Шаблоны проектов предоставляют файлы, необходимые для конкретного типа проекта, включая стандартные ссылки на сборки, задают свойства проекта и параметры компилятора по умолчанию. Project templates provide the files that are required for a particular project type, include standard assembly references, and set default project properties and compiler options. По сложности шаблоны элементов могут варьироваться от одного пустого файла с определенным расширением до нескольких файлов исходного кода, которые содержат код заглушек, файлы сведений о конструкторе и внедренные ресурсы. Item templates can range in complexity from a single empty file that has a certain file extension, to multiple source code files with stub code, designer information files, and embedded resources.

Вы можете использовать установленные шаблоны, создавать собственные шаблоны, а также скачивать и использовать шаблоны, созданные сообществом. You can use installed templates, author your own custom templates, or download and use templates created by the community. Дополнительные сведения см. в статьях Практическое руководство. Создание шаблонов проектов и Практическое руководство. Создание шаблонов элементов. For more information, see How to: Create project templates and How to: Create item templates.

Содержимое шаблона Contents of a template

Все шаблоны проектов и элементов, установленные с Visual Studio или созданные пользователем, работают на основе одних и тех же принципов и имеют схожее содержимое. All project and item templates, whether installed with Visual Studio or created by you, function using the same principles and have similar contents. Все шаблоны содержат следующие элементы: All templates contain the following items:

• Файлы, создаваемые при использовании шаблона. The files to be created when the template is used. Сюда входят файлы с исходным кодом, внедренные ресурсы, файлы проектов и т. д. These files include source code files, embedded resources, project files, and so on.

• Файл VSTEMPLATE, который содержит метаданные, необходимые для создания проекта или элемента из шаблона, а также для отображения шаблона в окнах Новый проект и Добавление нового элемента. A .vstemplate file, which contains the metadata needed to create a project or item from the template and to display the template in the New Project and Add New Item windows.

• Файл VSTEMPLATE, который содержит метаданные, необходимые для создания проекта или элемента из шаблона, а также для отображения шаблона на странице Создание проекта и в диалоговом окне Добавление нового элемента. A .vstemplate file, which contains the metadata needed to create a project or item from the template and to display the template on the Create a new project page or in the Add New Item dialog box.

Дополнительные сведения о VSTEMPLATE-файлах см. в статьях о тегах шаблона и параметрах шаблона. For more information about .vstemplate files, see Template tags and Template parameters.

Если эти файлы сжаты в ZIP-файл и помещены в соответствующую папку, Visual Studio автоматически отображает их в следующих расположениях: When these files are compressed into a .zip file and put in the correct folder, Visual Studio automatically displays them in the following places:

• Шаблоны проектов отображаются в окне Новый проект. Project templates appear in the New Project window.

• Шаблоны проектов отображаются на странице Создание проекта. Project templates appear on the Create a new project page.

• Шаблоны элементов отображаются в окне Добавление нового элемента. Item templates appear in the Add New Item window.

Дополнительные сведения о папках шаблонов см. в статье Практическое руководство. Размещение и упорядочение шаблонов. For more information about template folders, see How to: Locate and organize templates.

Практическое руководство. Создание шаблонов проектов How to: Create project templates

В этом разделе содержатся сведения о создании шаблона с помощью мастера экспорта шаблонов, который упаковывает шаблон в ZIP-файл. This topic shows you how to create a template using the Export Template Wizard, which packages your template in a .zip file.

Использование мастера экспорта шаблонов Use the Export Template Wizard

Создайте проект. Create a project.

Называя проект, который будет источником для шаблонов, используйте только допустимые символы идентификаторов. Use only valid identifier characters when naming a project that will be the source for a template. В противном случае в проектах, созданных из шаблона, могут возникать ошибки компиляции. Otherwise, compilation errors can occur in projects that are created from the template. Дополнительные сведения о допустимых символах идентификаторов см. в статьях Имена объявленных элементов (Visual Basic) и Идентификаторы (C++). For more information about valid identifier characters, see Declared element names (Visual Basic) or Identifiers (C++). Кроме того, можно использовать параметры шаблона, чтобы применять безопасные имена классов и пространств имен. Alternatively, you can use Template parameters to use «safe» names for classes and namespaces.

Внесите в проект все необходимые изменения, пока он не будет готов к сохранению в качестве шаблона. Edit the project until it is ready to be exported as a template. Например, может потребоваться отредактировать файлы кода, чтобы указать, где должна быть выполнена замена параметра. For example, you might want to edit code files to indicate where parameter replacement should take place. См. раздел Практическое руководство. Замена параметров в шаблоне. See How to: Substitute parameters in a template.

В меню Проект выберите команду Экспорт шаблона. On the Project menu, choose Export Template.

Открывается мастер экспорта шаблонов. The Export Template Wizard opens.

На странице Выбор типа шаблона выберите Шаблон проекта. On the Choose Template Type page, select Project Template. Выберите проект, который необходимо экспортировать в шаблон, а затем нажмите кнопку Далее. Select the project you want to export to a template, and then choose Next.

На странице Выбор параметров шаблона введите имя шаблона и необязательное описание, значок и рисунок предварительного просмотра для шаблона. On the Select Template Options page, enter a name and optional description, icon, and preview image for your template. Эти элементы будут отображаться в диалоговом окне Новый проект. These items will appear in the New Project dialog box. Нажмите кнопку Готово. Choose Finish.

Проект будет экспортирован в ZIP-файл и помещен в указанное выходное расположение, а также (если установлен соответствующий флажок) импортирован в Visual Studio. The project is exported into a .zip file and placed in the specified output location, and, if selected, imported into Visual Studio.

Чтобы найти шаблон в диалоговом окне Новый проект, разверните узел Установленные, а затем категорию, которая соответствует элементу ProjectType в VSTEMPLATE-файле. To find your template in the New Project dialog box, expand Installed and then expand the category that corresponds to the ProjectType element in the .vstemplate file. Например, VSTEMPLATE-файл, содержащий

, по умолчанию отображается в разделе Установленные > Visual C#. For example, a .vstemplate file that contains

appears under Installed > Visual C#, by default. Шаблон можно расположить во вложенном каталоге типа проекта. Для этого просто создайте папку в этом каталоге и поместите в нее ZIP-файл проекта. You can organize your template into a subdirectory of the project type just by creating a folder in that directory and placing your template’s .zip file in it. Дополнительные сведения см. в разделе Практическое руководство. размещать и упорядочивать шаблоны. For more information, see How to: Locate and organize templates.

На странице Выбор параметров шаблона введите имя шаблона и необязательное описание, значок и рисунок предварительного просмотра для шаблона. On the Select Template Options page, enter a name and optional description, icon, and preview image for your template. Эти шаблоны будут отображаться в диалоговом окне создания проекта. These items will appear in the dialog box where you create a new project. Нажмите кнопку Готово. Choose Finish.

Проект будет экспортирован в ZIP-файл и помещен в указанное выходное расположение, а также (если установлен соответствующий флажок) импортирован в Visual Studio. The project is exported into a .zip file and placed in the specified output location, and, if selected, imported into Visual Studio.

Чтобы найти шаблон в диалоговом окне создания проекта, можно использовать поиск по имени или прокрутку списка. To find your template in the dialog box where you create a new project, search for it by name or scroll through the list. (Фильтрация по языку или типу проекта для пользовательских шаблонов сейчас не поддерживается.) (Filtering based on language or project type is not currently possible for user templates.)

Другие способы создания шаблонов проектов Other ways to create project templates

Шаблоны проектов можно создать вручную, собрав файлы, образующие проект, в папку, а затем создав VSTEMPLATE-файл XML с соответствующими метаданными. You can create project templates manually by gathering the files that constitute the project into a folder and creating a .vstemplate XML file with the appropriate metadata. Дополнительные сведения см. в статье Практическое руководство. Создание веб-шаблонов вручную. For more information, see How to: Manually create web templates.

Если у вас установлен пакет SDK для Visual Studio, можно поместить готовый шаблон в оболочку (VSIX-файл для развертывания) с помощью шаблона Проект VSIX. If you have the Visual Studio SDK installed, you can wrap the finished template in a VSIX file for deployment by using the VSIX Project template. Дополнительные сведения см. в разделе Приступая к работе с использованием шаблона проекта VSIX. For more information, see Get started with the VSIX project template.

Создание приложения 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: