Руководство. Начало работы с C# и ASP.NET Core в Visual Studio

В этом руководстве по разработке C# с помощью ASP.NET Core вы создадите веб-приложение C# ASP.NET Core в Visual Studio.

В этом руководстве показано, как:

• Создание проекта Visual Studio
• Создание веб-приложения C# ASP.NET Core
• Внесение изменений в веб-приложение
• Изучение функций интегрированной среды разработки
• Запуск веб-приложения

Необходимые условия

Чтобы завершить работу с этим руководством, вам потребуется:

• Установлен Visual Studio. Перейдите на страницу загрузки Visual Studio, чтобы скачать бесплатную версию. Дополнительные сведения об обновлении до последней версии Visual Studio см. в обновлениях Visual Studio.
• Установлены ASP.NET и рабочий процесс веб-разработки. Чтобы проверить или установить эту рабочую нагрузку в Visual Studio, выберите Инструменты>Получить средства и компоненты. Дополнительные сведения см. в разделе Изменение рабочих нагрузок или отдельных компонентов.

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

Сначала вы создадите проект ASP.NET Core. Тип проекта включает в себя все файлы шаблонов, необходимые для создания полностью функционального веб-сайта.

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

   

2. В окне Создание проекта выберите C# из списка языков. Затем выберите Windows из списка Все платформы, и Веб из списка Все типы проектов.

   После применения фильтров языков, платформы и типов проекта выберите шаблон ASP.NET Core Web App (Razor Pages), а затем выберите Далее.

   

3. В окне Настройка нового проекта введите MyCoreApp в поле Имя проекта. Затем выберите Далее.

   

4. В окне Дополнительные сведения убедитесь, что .NET 8.0 появится в поле Target Framework.

   В этом окне можно включить поддержку контейнеров и добавить поддержку проверки подлинности. Раскрывающееся меню для типа проверки подлинности имеет следующие четыре варианта:

   • Нет: нет проверки подлинности.
   • отдельные учетные записи. Эти учетные данные хранятся в локальной базе данных или базе данных Azure.
   • платформа идентификации Microsoft: этот параметр использует Microsoft Entra ID или Microsoft 365 для проверки подлинности.
   • Windows: подходит для приложений интрасети.

   Оставьте флажок Включить поддержку контейнеров неустановленным и выберите Нет для типа проверки подлинности.

   

5. Выберите Создать.

Visual Studio открывает новый проект.

О вашем решении

Это решение следует шаблону проектирования Razor Page . Он отличается от шаблона проектирования модели -View-Controller (MVC,) тем, что код модели и контроллера непосредственно интегрированы в саму страницу Razor.

Обзор решения

1. Шаблон проекта создает решение с одним проектом ASP.NET Core с именем MyCoreApp. Выберите вкладку обозревателя решений, чтобы просмотреть его содержимое.

   

2. Разверните папку Pages.

   

3. Выберите файл Index.cshtml и просмотрите его в редакторе кода.

   

4. Каждый CSHTML-файл имеет связанный файл кода. Чтобы открыть файл кода в редакторе, разверните узел Index.cshtml в обозревателе решений и выберите файл Index.cshtml.cs.

   

5. Просмотрите файл Index.cshtml.cs в редакторе кода.

   

6. Проект содержит папку wwwroot, которая является корнем для веб-сайта. Разверните папку, чтобы просмотреть его содержимое.

   

   Вы можете поместить статический контент сайта, например CSS, изображения и библиотеки JavaScript, непосредственно в те пути, где они вам нужны.

7. Проект также содержит файлы конфигурации, управляющие веб-приложением во время выполнения. Конфигурация приложения по умолчанию хранится в appsettings.json. Однако эти параметры можно переопределить с помощью appsettings.Development.json. Разверните файл appsettings.json, чтобы просмотреть файл appsettings.Development.json.

   

Выполнение, отладка и внесение изменений

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

   

   Ескерім

   Вы также можете получить сообщение, которое спрашивает, хотите ли вы принять ssl-сертификат ASP.NET Core. Чтобы просмотреть код в веб-браузере, выберите Да, а затем выберите Да, если появится предупреждение системы безопасности. Дополнительные сведения о применении SSL см. в ASP.NET Core.

2. Visual Studio запускает окно браузера. Затем в строке меню должны отображаться домашняя страница и страница конфиденциальности.

3. Выберите Конфиденциальность в строке меню. Страница конфиденциальности в браузере отображает текст, заданный в файле Privacy.cshtml.

   

4. Вернитесь в Visual Studio и нажмите клавишу SHIFT+F5, чтобы остановить отладку. Это действие закрывает проект в окне браузера.

5. В Visual Studio откройте Privacy.cshtml для редактирования. Затем удалите предложение, Эту страницу можно использовать для подробной информации о политике конфиденциальности сайта и замените на Эта страница находится на стадии разработки с @ViewData["TimeStamp"].

   

6. Теперь давайте изменим код. Выберите Privacy.cshtml.cs. Затем очистите директивы using в верхней части файла, выбрав следующее сочетание клавиш:

   Наведите указатель мыши или выберите неактивную директиву using. Значок лампочки для быстрых действий отображается под курсором или на левом поле. Выберите лампочку, а затем щелкните стрелку развертывания рядом с Удалить ненужные.

   

   Теперь выберите просмотреть изменения, чтобы увидеть, какие изменения.

   

   Выберите Применить. Visual Studio удаляет ненужные директивы using из файла.

7. Затем создайте строку для текущей даты, отформатированной для вашего языка или региона, с помощью метода DateTime.ToString.

   • Первый аргумент метода указывает, как должна отображаться дата. В этом примере используется описатель формата (d), указывающий короткий формат даты.
   • Второй аргумент — это объект CultureInfo, который определяет культуру или региональные настройки для даты. Второй аргумент определяет, помимо прочего, язык любых слов в дате и тип используемых разделителей.

   Измените текст метода OnGet() в Privacy.cshtml.cs на следующий код:

   C#

   public void OnGet()
   {
      string dateTime = DateTime.Now.ToString("d", new CultureInfo("en-US"));
      ViewData["TimeStamp"] = dateTime;
   }
   

8. Обратите внимание, что следующая директива using автоматически добавляется в начало файла:

   C#

   using System.Globalization;
   

   System.Globalization содержит класс CultureInfo.

9. Нажмите F5, чтобы открыть проект в веб-браузере.

10. В верхней части веб-сайта выберите Конфиденциальность, чтобы просмотреть изменения.

    

11. Закройте веб-браузер , нажмите клавиши SHIFT+F5, чтобы остановить отладку.

Изменение домашней страницы

1. В обозревателе решений разверните папку Pages и выберите Index.cshtml.

   

   Файл Index.cshtml соответствует домашней странице в веб-приложении, которое выполняется в веб-браузере.

   

   В редакторе кода вы видите HTML-код текста, который появляется на странице Главная.

   

2. Замените текст Welcome на Hello World!

   

3. Выберите https или нажмите клавиши CTRL +F5, чтобы запустить приложение и открыть его в веб-браузере.

   

4. В веб-браузере вы увидите новые изменения на странице home.

   

5. Закройте веб-браузер, нажмите клавиши SHIFT +F5, чтобы остановить отладку и сохранить проект. Теперь вы можете закрыть Visual Studio.

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

Поздравляем с завершением работы с этим руководством! Мы надеемся, что вам понравилось узнавать о C#, ASP.NET Core и интегрированной среде разработки Visual Studio. Дополнительные сведения о создании веб-приложения или веб-сайта с помощью C# и ASP.NET см. в следующем руководстве:

создание веб-приложения Razor Pages с помощью ASP.NET Core

Кроме того, узнайте, как контейнеризировать веб-приложение с помощью Docker:

Средства контейнеров в Visual Studio

Связанные ссылки

• опубликовать веб-приложение в Службе приложений Azure с помощью Visual Studio
• Персонализируйте интегрированную среду разработки и редактор Visual Studio