ASP.NET

8 уроков
100 заданий
#2 - Настройки проекта

#2 - Настройки проекта

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

Видеоурок

Для создания кода под ASP .NET Core у нас есть возможность применять разный инструментарий. Если основная платформа Виндовс, можем воспользоваться многофункциональной и распространённой средой Visual Studio. Если разрабатываемое ПО заточено под Linux или Mac OS, скорее всего выбор падёт на расширенные редактор Visual Studio Code. Ничего не мешает использовать его и в Windows. В пределах данного материала предпочтение отдаём разработке в VS 2017. Достаточный функционал есть и у VS 2015.


Нужная нам программа доступна на официальной странице. Конкретно в этом случае нет принципиальной разницы в версии VS: подойдёт как бесплатная, так и профессиональная или корпоративная. Каждая из перечисленных версий обладает предустановленными средствами для разработки ПО на ASP .NET Core. Мы не будем заморачиваться и воспользуемся бесплатным вариантом - VS 2017 Community.


Уже сейчас у нас на компьютере есть установщик (доступный по ссылке), осталось его лишь установить. Во время первоначальной настройке предлагается добавить несколько опций. Учитывая, что мы планируем работать с ASP .NET Core, предпочтительно выбирать пункт «ASP .NET и разработка веб-приложений».


После одного нажатия на данный пункт справа показывается меню «Сводка», в котором можем установить некоторые необязательные компоненты. Сейчас можем установить все предложенные дополнения.


Немного ниже описанного пункта есть ещё один, обязательный в нашем случае – «Кроссплатформенная разработка .NET Core»:



Только после выделения необходимых дополнений можем начать инсталляцию Visual Studio.


Довольно часто в системе уже есть VS и, возможно, платформа была добавлена в систему когда-то давно. Работать в устаревшей версии Visual Studio – не лучшая идея, поэтому стоит обновить данное ПО до актуального состояния. Ещё рекомендуем произвести установку компонента DK .NET Core 2.1, он позволит использовать самые новые функции ASP .NET Core.


Как только установка завершена (занимает немного времени), время открыть VS 2017. В окне приложения щёлкаем по кнопке File («Файл»), выбираем New («Новый»), а затем – Project («Проект»). Сейчас должно появиться окно, в котором можем создать новый проект. Слева в меню открываем раздел «Web».



Здесь появляется выбор среди двух разновидностей проектов:

  • ASP .NET Core Web Application: применяется для программирования приложений для веба на ASP .NET Core;
  • ASP .NET Web Application (.NET Framework): этот тип применим для классических проектов: Web Forms, MVC 5, Web Api, основанных на обычном .NET Framework.


Важно! Здесь используем исключительно первый пункт, инструкция актуальна для этого типа проекта.


После выбора нужного варианта нам предлагают указать наименование текущего проекта. Рекомендуем устанавливать «говорящее» название, чтобы при первом взгляде и через 5 лет получилось легко вспомнить, что собой представляет данное приложение. Для примера, мы назовём проект HelloApp, затем нажимаем клавишу «Ок».


Сразу после этого отображается окно, в котором нас просят выбрать подходящий для работы шаблон:



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

  • Empty: создаёт чистый шаблон без дополнительных функций. Применяется для написания приложений с чистого листа;
  • Web API: проект веб-службы;
  • Web Application: в качестве обработчика запросов проект применяет Razor Pages;
  • Web Application: проект, построенный на архитектуре модель-вид-контроллер;
  • Angular: работает на Angular 2+;
  • Reat js: основа - React.JS;
  • Reat JS and Redux: строится на React JS и Redux;
  • Razor Class Library: проект, заточенный под разработку с Razor.


Помимо перечисленного, здесь же есть возможность ставить желаемую версию ASP .NET Core, она доступна после клика на открывающийся список. Сейчас вполне достаточно версии 2.1, она стоит изначально.


Ещё здесь присутствует возможность указания метода аутентификации и подключения Docker-контейнера.


Обращаем внимание на запись «Configure HTTP», если её активировать весь проект во время отладки и тестов будет работать через SSL-протокол. Для нашего случая нет принципиальной разницы активировать эту функцию или оставить выключенной. Эту настройку можем в любой момент заменить, но это придётся делать посредством свойств проекта.


Нам сейчас подходит проект «Empty», а дополнительные настройки можем оставить в стандартном положении. Последний шаг создания проекта – нажимаем кнопку «Ок».

Структура проекта ASP .NET Core

Для лучшего понимания проекта, мы расскажем о базовых элементах структуры в стандартном примере. У шаблона Empty элементарная структура – это как раз тот минимум, который нужен для пуска любого приложения.


Структура:

  • Connected Services: список синхронизированных сервисов Azure;
  • Dependencies: все встроенные библиотеки, скрипты или проще – зависимости;
  • wwwroot: узел применяется для сохранения файлов-констант, которые не меняются в процессе работы. Сюда относятся JS-скрипты, CSS-файлы, картинки и прочее. Всё перечисленное находится в одноимённой папке. Данный каталог вынесен отдельным элементом в проект для простоты установки уровней доступа к файлам. Таким образом легко разрешить доступ к картинкам сервера, но запретить – к скриптам;
  • Program.cs: ключевой файл создаваемого ПО, именно он обрабатывается в первую очередь. Код отсюда выполняет настройку и запуск веб-хоста в пределах приложения;
  • Startup.cs: файл для установки класса Startup. В нём обычно размещается логика работы с поступающими запросами.


В полнофункциональном приложении структура значительно шире, но эта база есть практически всегда. После запуска созданного по инструкции проекта, любой веб-обозреватель покажет запись «Hello World!», она отправляется через класс Startup.

Материалы для курса

Чтобы скачивать материалы к видеокурсам необходимо оформить подписку на сайт

Задание к уроку

Необходимо оформить подписку на проект, чтобы получить доступ ко всем домашним заданиям

Большое задание по курсу

Вам необходимо оформить подписку на сайте, чтобы иметь доступ ко всем большим заданиям. В задание входит методика решения, а также готовый проект с ответом к заданию.
PS: подобные задания доступны при подписке от 1 месяца

Также стоит посмотреть

Уроки C# под Unity 5 для начинающих
9 уроков
Изучение C#, ASP.NET и создание Windows программ
Изучение языка C# для начинающих
26 уроков