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

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

   

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

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

   

3. В окне Настройка нового проекта введите MyCoreApp в поле имени проекта . Затем нажмите кнопку Далее.

   

4. В окне Дополнительные сведения убедитесь, что .NET Core 3.1 находится в поле целевой платформы.

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

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

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

   

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

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

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

   

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

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

   

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

   

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

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

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

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

   

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

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

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

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, непосредственно по требуемым путям.

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

7. Разверните файл appsettings.json, чтобы просмотреть файл appsettings.Development.json.

   

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

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

   

   Заметка

   Если появится сообщение об ошибке, которое говорит, что не удается подключиться к веб-серверу IIS Express, закройте Visual Studio и снова запустите программу в качестве администратора. Эту задачу можно выполнить, щелкнув правой кнопкой мыши значок Visual Studio в меню "Пуск" и выбрав параметр Запустить от имени администратора в контекстном меню.

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

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

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

   

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

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

   

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

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

   ru-RU:

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

   

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

7. Затем в методе OnGet() измените текст на следующий код:

   public void OnGet()
   {
      string dateTime = DateTime.Now.ToShortDateString();
      ViewData["TimeStamp"] = dateTime;
   }
   

8. Обратите внимание, что в DateTimeпоявляется волнистое подчеркивание. Волнистое подчеркивание появляется, так как этот тип не входит в область видимости.

   на снимке экрана

   Откройте панель инструментов списка ошибок , чтобы увидеть те же ошибки, перечисленные там. Если панель инструментов списка ошибок не отображается, перейдите в раздел Просмотр списка ошибок в верхней строке меню.

   

9. Давайте исправим эту ошибку. В редакторе кода поместите курсор на строку, содержащую ошибку, и выберите лампочку быстрых действий в левом поле. Затем в раскрывающемся меню выберите , используя System;, чтобы добавить эту директиву в начало файла и устранить ошибки.

   

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

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

    

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

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

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

   

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

   

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

   

2. Замените текст приветствие на Hello World!

   

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

   

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

   

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

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

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 на следующий код:

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

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

   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.