Руководство. Начало работы с C# и ASP.NET Core в Visual Studio
Область применения:Visual Studio Visual Studio
для Mac
Visual Studio Code
В этом учебнике по разработке в C# и ASP.NET Core вы создадите веб-приложение ASP.NET Core на языке C# в Visual Studio.
В этом учебнике показано, как выполнять следующие действия.
- Создание проекта Visual Studio
- Создание веб-приложения ASP.NET Core на языке C#
- Внесение изменений в веб-приложение
- Знакомство с функциями интегрированной среды разработки
- Запуск веб-приложения
Предварительные условия
Для выполнения шагов, описанных в этом учебнике, вам понадобится Visual Studio. Перейдите на страницу загрузки Visual Studio, чтобы получить бесплатную версию.
Дополнительные сведения об обновлении до актуальной версии Visual Studio см. в статье Обновления Visual Studio.
Сведения о настройке интерфейса Visual Studio см. в статье Персонализация интегрированной среды разработки и редактора Visual Studio.
Создание проекта
Сначала вы создадите проект ASP.NET Core. Проект этого типа содержит все файлы шаблонов, необходимые для создания полнофункционального веб-сайта.
В окне запуска выберите Создание нового проекта.
В окне Создание проекта в списке языков выберите C#. Затем выберите Windows в списке платформ и Веб-сайт в списке типов проектов.
Применив фильтры по языку, платформе и типу проекта, выберите шаблон Веб-приложение ASP.NET Core и нажмите Далее.
Заметка
Если шаблон Консольное приложение отсутствует, его можно установить в окне Создание проекта. В сообщении Не нашли то, что искали?, которое отображается в нижней части списка шаблонов, выберите ссылку Установка других средств и компонентов.
Затем в Visual Studio Installer выберите рабочую нагрузку ASP.NET и разработка веб-приложений.
В Visual Studio Installer выберите Изменить. Вам может быть предложено сохранить результаты работы. Выберите Продолжить, чтобы установить рабочую нагрузку.
В поле Имя проекта окна Настроить новый проект введите MyCoreApp. Затем выберите Далее.
Убедитесь, что в окне Дополнительные сведения, в поле Целевая платформа отображается значение .NET Core 3.1. В этом окне можно включить поддержку Docker и добавить поддержку проверки подлинности. В раскрывающемся меню Тип проверки подлинности имеется четыре варианта:
- Нет. Без проверки подлинности.
- Индивидуальные учетные записи. Они хранятся в локальной базе данных или базе данных Azure.
- Платформа удостоверений Майкрософт. В этом параметре для аутентификации используется Active Directory, Azure AD или Microsoft 365.
- Windows. Подходит для приложений интрасети.
Не устанавливайте флажок Включить Dockerи установите флажок Нет в разделе "Тип проверки подлинности". Далее выберите Создать.
В Visual Studio откроется новый проект.
В окне запуска выберите Создание нового проекта.
В окне Создание проекта в списке языков выберите C#. Затем выберите Windows в списке платформ и Веб-сайт в списке типов проектов.
Применив фильтры по языку, платформе и типу проекта, выберите шаблон Веб-приложение ASP.NET Core и нажмите Далее.
Заметка
Если шаблон Консольное приложение отсутствует, его можно установить в окне Создание проекта. В сообщении Не нашли то, что искали?, которое отображается в нижней части списка шаблонов, выберите ссылку Установка других средств и компонентов.
После этого в Visual Studio Installer выберите рабочую нагрузку ASP.NET и разработка веб-приложений.
В Visual Studio Installer выберите Изменить. Вам может быть предложено сохранить результаты работы. Выберите Продолжить, чтобы установить рабочую нагрузку.
В поле Имя проекта окна Настроить новый проект введите MyCoreApp. Затем выберите Далее.
Убедитесь, что в окне Дополнительные сведения, в поле Целевая платформа отображается значение .NET 6.0. В этом окне можно включить поддержку Docker и добавить поддержку проверки подлинности. В раскрывающемся меню Тип проверки подлинности имеется четыре варианта:
- Нет. Без проверки подлинности.
- Индивидуальные учетные записи. Они хранятся в локальной базе данных или базе данных Azure.
- Платформа удостоверений Майкрософт. В этом параметре для аутентификации используется Active Directory, Azure AD или Microsoft 365.
- Windows. Подходит для приложений интрасети.
Не устанавливайте флажок Включить Dockerи установите флажок Нет в разделе "Тип проверки подлинности". Далее выберите Создать.
В Visual Studio откроется новый проект.
Сведения о решении
Это решение основано на конструктивном шаблоне Страница Razor. Он отличается от конструктивного шаблона Model-View-Controller (MVC) тем, что содержит код модели и управляющий код в самой странице Razor.
Обзор решения
С помощью шаблона проекта создается решение с одним проектом ASP.NET Core, который имеет имя MyCoreApp. Перейдите на вкладку Обозреватель решений, чтобы просмотреть его содержимое.
Разверните папку Pages.
Выберите файл index.cshtml и просмотрите его в редакторе кода.
С каждым файлом CSHTML связан файл кода. Чтобы открыть файл кода в редакторе, разверните узел Index.cshtml в обозревателе решений и выберите файл Index.cshtml.cs.
Просмотрите файл Index.cshtml.cs в редакторе кода.
Проект содержит папку wwwroot, которая является корневой для веб-сайта. Разверните папку, чтобы просмотреть его содержимое.
Вы можете поместить статическое содержимое сайта, например CSS, изображения и библиотеки JavaScript, напрямую в нужные пути.
Проект также содержит файлы конфигурации для управления веб-приложением во время выполнения. Стандартная конфигурация приложения хранится в файле appsettings.json. Тем не менее эти параметры можно переопределить с помощью appsettings.Development.json. Разверните файл appsettings.json, чтобы просмотреть файл appsettings.Development.json.
Запуск, отладка и внесение изменений
Нажмите кнопку IIS Express на панели инструментов, чтобы выполнить сборку приложения и запустить его в режиме отладки. Кроме того, можно нажать клавишу F5 или выбрать пункт меню Отладка>Начать отладку в строке меню.
Заметка
Если выводится сообщение об ошибке с текстом Не удается подключиться к веб-серверу IIS Express, закройте Visual Studio и запустите программу от имени администратора. Это можно сделать, щелкнув правой кнопкой мыши значок Visual Studio в меню пуск, а затем выбрав в контекстном меню пункт Запуск от имени администратора.
Может также появиться запрос о том, хотите ли вы принять сертификат IIS SSL Express. Чтобы просмотреть код в веб-браузере, выберите Да, а затем снова Да, если появится предупреждение системы безопасности о дальнейшей обработке.
Visual Studio откроет окно браузера. В строке меню вы должны увидеть названия страниц Home (Главная) и Privacy (Конфиденциальность).
Выберите в строке меню страницу Privacy. На открытой в браузере странице Privacy отображается текст, заданный в файле Privacy.cshtml.
Вернитесь в Visual Studio и нажмите клавиши SHIFT+F5, чтобы завершить отладку. Также после этого закроется проект в окне браузера.
В Visual Studio откройте файл Privacy.cshtml для редактирования. Затем удалите строку Use this page to detail your site's privacy policy (Эта страница предназначена для политики конфиденциальности сайта) и добавьте вместо нее строку This page is under construction as of @ViewData["TimeStamp"] (Эта страница находится в разработке с ["метка_времени"]).
Теперь изменим код. Выберите файл Privacy.cshtml.cs. Затем очистите директивы
using
в начале файла, как описано ниже.Выберите любую из выделенных серым цветом директив
using
Под курсором или в поле слева отобразится меню Быстрые действия (значок лампочки). Выберите лампочку, а затем команду Удалить ненужные директивы Using.Теперь выберите команду Просмотреть изменения, чтобы увидеть, что изменится.
Выберите Применить. Visual Studio удалит из файла ненужные директивы
using
.Затем в методе
OnGet()
замените основную часть таким кодом:public void OnGet() { string dateTime = DateTime.Now.ToShortDateString(); ViewData["TimeStamp"] = dateTime; }
Обратите внимание, что в поле DateTime отображается подчеркивание волнистой линией. Подчеркивание волнистой линией появилось, потому что этот тип находится за пределами области.
Откройте панель инструментов Список ошибок, чтобы просмотреть там те же самые ошибки. Если вы не видите панель инструментов Список ошибок, выберите Представление>Список ошибок в верхней строке меню.
Давайте исправим эту ошибку. В редакторе кода установите курсор в любую строку с ошибкой, а затем в поле слева выберите меню "Быстрые действия" (значок лампочки). В раскрывающемся меню выберите using System;, чтобы добавить эту директиву в начало файла и устранить ошибки.
Нажмите клавишу F5, чтобы открыть проект в веб-браузере.
В верхней части веб-сайта выберите пункт Privacy (Конфиденциальность), чтобы просмотреть изменения.
Закройте веб-браузер, нажмите клавиши SHIFT+F5, чтобы остановить отладку.
Изменение главной страницы
В обозревателе решений разверните папку Страницы и выберите Index.cshtml.
Файл Index.cshtml соответствует странице с заголовком Home (Главная) веб-приложения, которое запускается в веб-браузере.
В редакторе отображается HTML-код для текста, содержащегося на странице Home (Главная).
Замените текст Welcome на Hello World!
Выберите IIS Express или нажмите клавиши CTRL+F5, чтобы запустить приложение и открыть его в веб-браузере.
В веб-браузере вы увидите новые изменения на странице Home (Главная).
Закройте веб-браузер, нажмите клавиши SHIFT+F5, чтобы остановить отладку, и сохраните проект. Теперь можно закрыть Visual Studio.
Обзор решения
С помощью шаблона проекта создается решение с одним проектом ASP.NET Core, который имеет имя MyCoreApp. Перейдите на вкладку Обозреватель решений, чтобы просмотреть его содержимое.
Разверните папку Pages.
Выберите файл index.cshtml и просмотрите его в редакторе кода.
С каждым файлом CSHTML связан файл кода. Чтобы открыть файл кода в редакторе, разверните узел Index.cshtml в обозревателе решений и выберите файл Index.cshtml.cs.
Просмотрите файл Index.cshtml.cs в редакторе кода.
Проект содержит папку wwwroot, которая является корневой для веб-сайта. Разверните папку, чтобы просмотреть его содержимое.
Вы можете поместить статическое содержимое сайта, например CSS, изображения и библиотеки JavaScript, напрямую в нужные пути.
Проект также содержит файлы конфигурации для управления веб-приложением во время выполнения. Стандартная конфигурация приложения хранится в файле appsettings.json. Тем не менее эти параметры можно переопределить с помощью appsettings.Development.json. Разверните файл appsettings.json, чтобы просмотреть файл appsettings.Development.json.
Запуск, отладка и внесение изменений
Нажмите кнопку IIS Express на панели инструментов, чтобы выполнить сборку приложения и запустить его в режиме отладки. Кроме того, можно нажать клавишу F5 или выбрать пункт меню Отладка>Начать отладку в строке меню.
Заметка
Если выводится сообщение об ошибке с текстом Не удается подключиться к веб-серверу IIS Express, закройте Visual Studio и запустите программу от имени администратора. Это можно сделать, щелкнув правой кнопкой мыши значок Visual Studio в меню пуск, а затем выбрав в контекстном меню пункт Запуск от имени администратора.
Может также появиться запрос о том, хотите ли вы принять сертификат IIS SSL Express. Чтобы просмотреть код в веб-браузере, выберите Да, а затем снова Да, если появится предупреждение системы безопасности о дальнейшей обработке.
Visual Studio откроет окно браузера. В строке меню вы должны увидеть названия страниц Home (Главная) и Privacy (Конфиденциальность).
Выберите в строке меню страницу Privacy. На открытой в браузере странице Privacy отображается текст, заданный в файле Privacy.cshtml.
Вернитесь в Visual Studio и нажмите клавиши SHIFT+F5, чтобы завершить отладку. Также после этого закроется проект в окне браузера.
В Visual Studio откройте файл Privacy.cshtml для редактирования. Затем удалите строку Use this page to detail your site's privacy policy (Эта страница предназначена для политики конфиденциальности сайта) и добавьте вместо нее строку This page is under construction as of @ViewData["TimeStamp"] (Эта страница находится в разработке с ["метка_времени"]).
Теперь изменим код. Выберите файл Privacy.cshtml.cs. Очистите директивы
using
в начале файла, как описано ниже.Выберите любую из выделенных серым цветом директив
using
Под курсором или в поле слева отобразится меню Быстрые действия (значок лампочки). Выберите лампочку, а затем щелкните стрелку развертывания рядом с удалением ненужных операций.Теперь выберите команду Просмотреть изменения, чтобы увидеть, что изменится.
Выберите Применить. Visual Studio удалит из файла ненужные директивы
using
.Затем создайте строку с текущей датой, отформатированной в соответствии с вашим языком и региональными параметрами или регионом, с помощью метода DateTime.ToString.
- Первый аргумент метода указывает, как должна отображаться дата. В этом примере используется описатель формата (
d
), который указывает короткий формат даты. - Вторым аргументом является объект CultureInfo, указывающий язык и региональные параметры или регион для даты. Второй аргумент определяет, помимо прочего, язык любых слов в дате и тип используемых разделителей.
В методе
OnGet()
измените текст на следующий код.public void OnGet() { string dateTime = DateTime.Now.ToString("d", new CultureInfo("en-US")); ViewData["TimeStamp"] = dateTime; }
- Первый аргумент метода указывает, как должна отображаться дата. В этом примере используется описатель формата (
Обратите внимание, что следующая
using
директива автоматически добавляется в начало файла:using System.Globalization;
System.Globalization
содержит класс CultureInfo .Нажмите клавишу F5, чтобы открыть проект в веб-браузере.
В верхней части веб-сайта выберите пункт Privacy (Конфиденциальность), чтобы просмотреть изменения.
Закройте веб-браузер, нажмите клавиши SHIFT+F5, чтобы остановить отладку.
Изменение главной страницы
В обозревателе решений разверните папку Страницы и выберите Index.cshtml.
Файл Index.cshtml соответствует странице с заголовком Home (Главная) веб-приложения, которое запускается в веб-браузере.
В редакторе отображается HTML-код для текста, содержащегося на странице Home (Главная).
Замените текст Welcome на Hello World!
Выберите IIS Express или нажмите клавиши CTRL+F5, чтобы запустить приложение и открыть его в веб-браузере.
В веб-браузере вы увидите новые изменения на странице Home (Главная).
Закройте веб-браузер, нажмите клавиши SHIFT+F5, чтобы остановить отладку, и сохраните проект. Теперь можно закрыть Visual Studio.
Далее
Поздравляем с завершением этого учебника! Надеемся, что вам понравилось изучать C#, ASP.NET Core и интегрированную среду разработки Visual Studio. Дополнительные сведения о создании веб-приложения или веб-сайта с помощью C# и ASP.NET вы найдете в следующих руководствах:
Или узнайте, как контейнеризировать веб-приложения с помощью Docker:
См. также
Публикация веб-приложения в службе приложений Azure с помощью Visual Studio