Введение в ASP.NET Core

Первый проект на Visual Basic .NET

ASP.NET Core представляет кроссплатформенный фреймворк для создания веб-приложений самого различного типа на платформе .NET. Кроссплатформенность фреймфорка позволяет как создавать приложения на всех основных популярных операционных системах: Windows, Mac OS, Linux, так и запускать созданные приложения на этих ОС.

ASP.NET Core позволяет создавать веб-приложений с помощью различных моделей разработки.

• Прежде всего это базовый ASP.NET Core, который поддерживает все основные моменты, необходимые для работы соввременного веб-приложения: маршрутизация, конфигурация, логгирования, возможность работы с различными системами баз данных и т.д.. В ASP.NET Core 6 в фреймворк был добавлен так называемый Minimal API - минимизированная упрощенная модель, который еще упростила процесс разработки и написания кода приложения. Все остальные модели разработки работаю поверх базового функционала ASP.NET Core

• ASP.NET Core MVC представляет в общем виде построения приложения вокруг трех основных компонентов - Model (модели), View (представления) и Controller (контроллеры), где модели отвечают за работу с данными, контроллеры представляют логику обработки запросов, а представления определяют визуальную составляющую.

• Razor Pages представляет модель, при котором за обаботку запроса отвечают специальные сущности - страницы Razor Pages. Каждую отдельную такую сущность можно ассоциировать с отдельной веб-страницей.

• ASP.NET Core Web API представляет реализацию паттерна REST, при котором для каждого типа http-запроса (GET, POST, PUT, DELETE) предназначен отдельный ресурс. Подобные ресурсы определяются в виде методов контроллера Web API. Данная модель особенно подходит для одностраничных приложений, но не только.

• Blazor представляет фреймворк, который позволяет создавать интерактивные приложения как на стороне сервера, так и на стороне клиента и позволяет задействовать на уровне браузера низкоуровневый код WebAssembly.

Для разработки на ASP.NET Core мы можем использовать среду Visual Studio от компании Microsoft. Также можно использовать для разработки среду Rider от компании JetBrains. Кроме того, имеющаяся оснастка .NET CLI позволяет создвать и запускать проекты ASP.NET в консоли. И таким образом, для написания кода можно использовать обычных текстовый редактор, например, Visual Studio Code.

Однако если мы говоримо разработке веб-приложений на Visual Basic .NET, то стоит отметить, что по умолчанию в .NET 6 поддерживается создание веб-проектов только для языков C# и F#. Тем не менее это не является препятствием для веб-разработки на Visual Basic .NET. Рассмотрим, как создаать простейший проект.

Создание проекта для Visual Basic .NET

Для создания веб-приложений на Visual Basic .NET будем использовать среду разработки - Visual Studio Community 2022, которую можно загрузить по следующему адресу: Microsoft Visual Studio 2022

Чтобы добавить в Visual Studio поддержку проектов для ASP.NET Core, в программе установки среди рабочих нагрузок можно выбрать только пункт ASP.NET и разработка веб-приложений. Можно выбрать и больше опций или вообще все опции, однако стоит учитывать свободный размер на жестком диске - чем больше опций будет выбрано, соответственно тем больше места на диске будет занято.

После завершения установки создадим первый проект на ASP.NET 6. Вначале откроем Visual Studio. На стартовом экране выберем Create a new project (Создать новый проект)

Поскольку по умолчанию для Visual Basic отсутствуют шаблоны проекты в Visual Studio, то на следующем окне в качестве языка выберем Visual Basic, а в качестве типа проекта Console App (не путать с другим шаблоном - Console App (.NET Framework))

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

Далее на следующем этапе нам будет предложено указать имя проекта и каталог, где будет располагаться проект.

В поле Project Name дадим проекту какое-либо название. В моем случае это HelloApp.

На следующем окне Visual Studio предложит нам выбрать версию .NET, которая будет использоваться для проекта. По умолчанию здесь выбрана последняя на данный момент версия - .NET 6.0.

Нажмем на кнопку Create (Создать) для создания проекта. После этого Visual Studio создаст и откроет нам проект стандартного консольного приложения, и нам надо превратить его в проект веб-приложения. Для этого в структуре проекта нажмем правой кнопкой мыши на название проекта и в контекстном меню выберем пункт Edit Project file:

То есть по сути мы открыли файл HelloApp.vbproj. По умолчанию содержимое файла выглядит примерно следующим образом:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <RootNamespace>HelloApp</RootNamespace>
    <TargetFramework>net6.0</TargetFramework>
  </PropertyGroup>

</Project>

Теперь изменим этот код на следующий:

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <RootNamespace>HelloApp</RootNamespace>
    <TargetFramework>net6.0</TargetFramework>
  </PropertyGroup>

</Project>

Фактически здесь мы только изменяем первую строку, которая указывает на используемый SDK - меняем его с Microsoft.NET.Sdk на Microsoft.NET.Sdk.Web. После изменения SDK сохраним файл и перезагрузим проект. Будут загружены все необходимые пакеты и содержимое проекта немного изменится:

Определение кода приложения

Хотя мы изменил тип проекта, но по сути он пока содержит тот же код, что и стандартный проект консольного приложения. Поэтому перейдем к файлу Program.vb и изменим его код следующим образом:

Imports Microsoft.AspNetCore.Builder

Module Program
    Sub Main(args As String())
        'Получаем класс-строитель приложения
        Dim builder = WebApplication.CreateBuilder(args)

        'Создаем объект приложения
        Dim app = builder.Build()

        'Определяем обработку запроса по пути "/"
        app.MapGet("/", Function() "Hello METANIT.COM!")

        'запуск приложения
        app.Run()
    End Sub
End Module

Приложение в ASP.NET Core .NET 6 представляет объект Microsoft.AspNetCore.Builder.WebApplication. Этот объект настраивает всю конфигурацию приложения, его маршруты, используемые зависимости и т.д.

Для создания объекта WebApplication необходим специальный класс-строитель - WebApplicationBuilder. И в файле Program.vb вначале создается данный объект с помощью статического метода WebApplication.CreateBuilder:

Dim builder = WebApplication.CreateBuilder(args)

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

Получив объект WebApplicationBuilder, у него вызывается метод Build(), который собствено и создает объект WebApplication:

Dim app = builder.Build()

С помощью объекта WebApplication можно настроить всю инфраструктуру приложения - его конфигурацию, маршруты и так далее. В файле Program.vb по умолчанию для приложения определяется один маршрут:

app.MapGet("/", Function() "Hello METANIT.COM!")

Метод MapGet() в качестве первого параметра принимает путь, по которому можно обратиться к приложению. В данном случае это путь "/", то есть по сути корень веб-приложения - имя домена и порта, после которых может идти слеш, например, https://localhost:7256/

В качестве второго параметра в метод MapGet() передаются обработчик запроса по этому маршруту в виде функции. Здесь это лямбда-выражение, которое возвращает строку "Hello METANIT.COM!". Именно поэтому при обращении к приложению мы увидим данную строку в браузере.

И в конце необходимо запустить приложение. Для этого у класса WebApplication вызывается метод Run():

app.Run()

Запустим проект и в браузере мы увидим строку "Hello METANIT.COM!" - результат работы кода файла Program.vb: