Перейти к основному содержимому

Документация и практика ASP.NET (Microsoft Learn)

ОБЯЗАТЕЛЬНОДЛЯ НОВИЧКОВ
Разработчику

В энциклопедии ASP.NET разобран как платформа (обзор, справочник-шпаргалка, первая программа). Microsoft Learn даёт актуальные учебники и хаб документации на русском — их проходят после базовых глав по C# и HTTP, иначе теряется связь между Program.cs, маршрутизацией и MVC.

Тексты статей Learn сюда не копируются — только структура, ссылки и привязка к разделам проекта.

С чего начать​

ШагГде в энциклопедииОфициальный источник
1Практика C# на LearnGet started C#
2Первая программа ASP.NET CoreПриложение за 5 минут
3ASP.NET — фреймворкХаб документации ASP.NET Core
4aЭта глава → Razor Pages (рекомендуется новичкам)Серия Razor Pages
4bЭта глава → серия MVCНачало работы с MVC
5Сборка и публикацияРазмещение и Docker (Core)

Интерактивный каталог: Microsoft Learn — навигатор · Подборка документации.

Как выбрать первую ветку обучения​

Если цель — быстро запустить рабочее CRUD-приложение, начинайте с Razor Pages. Если цель — строить API для фронтенда/мобильного клиента, стартуйте с Minimal API или контроллеров Web API. Оба пути остаются внутри ASP.NET Core и используют единые базовые механизмы — DI, middleware, конфигурацию и логирование.

Хаб документации ASP.NET Core 10​

Документация по ASP.NET — входная точка для .NET 10: обзор, учебники, справочник API и разделы по типам приложений.

Быстрый старт​

ТемаСсылка
Приложение за 5 минутget-started
Обзор платформыintroduction-to-aspnet-core
Первый Web APImin-web-api
SignalRsignalr tutorial

Модели веб-приложений (выбор UI)​

ПодходКогда выбиратьСтарт на Learn
Minimal APIТонкий HTTP-слой, микросервисыminimal web API
Web API + контроллерыREST с атрибутами, Swaggerконтроллеры
Razor PagesСтраничный UI, CRUD; проще старт, чем MVCсерия Razor Pages
MVCКлассическое разделение Model–View–Controllerstart-mvc
BlazorSPA на C# (Server / WebAssembly)blazor

Сравнение Razor Pages, MVC и Blazor: choose-web-ui.

Данные, безопасность, развёртывание​

Раздел хабаСсылкаСвязь с энциклопедией
EF Core + Razor Pagesef-rp introASP.NET - фреймворк для веб-приложений, серия ниже
EF Core + MVCef-mvc introASP.NET - фреймворк для веб-приложений, Приложение с S3, PostgreSQL и ASP.NET Core Web API
БезопасностьsecurityБезопасность приложений на C# — безопасность C#
Kestrel / IISservers overviewASP.NET - фреймворк для веб-приложений — хостинг
Docker (ASP.NET Core)host-and-deploy/docker8.04 DevOps
Справочник API.NET API browserСправочник по ASP.NET — справочник

Схема обучения с модулями и баллами: Создание веб-приложений ASP.NET Core (см. навигатор Learn).

Серия Razor Pages — RazorPagesMovie​

Создание веб-приложения Razor Pages — оглавление серии на .NET 10. Microsoft рекомендует этот путь новичкам в ASP.NET Core (вместо MVC с контроллерами). Архитектура и понятия: Razor Pages в ASP.NET Core.

Что даёт серия​

К концу — то же предметное приложение, что и в MVC-серии: каталог фильмов с отображением, редактированием и EF Core. Отличие модели: логика привязана к странице (PageModel), а не к контроллеру + представлению.

Первый проект: RazorPagesMovie, .NET 10, без top-level statements (как в учебнике). Шаблон Visual Studio: ASP.NET Core Web App (Razor Pages).

Порядок частей серии​

№ТемаURL (view=aspnetcore-10.0)
—Оглавление серииrazor-pages
1Создание приложенияrazor-pages-start
2Модельmodel
3Scaffolding страницpage
4База данныхsql
5Обновление связанных данныхda1
6Поискsearch
7Новое полеnew-field
8Валидацияvalidation

После части 1 закрепите в справочнике разделы про Razor Pages, PageModel и Tag Helpers.

MVC или Razor Pages? Одну серию для старта — не обе сразу. Сравнение: choose-web-ui. Если уже знакомы с контроллерами — переходите к серии MvcMovie ниже.

Что важно закрепить после Razor Pages​

  • модель PageModel и жизненный цикл OnGet/OnPost;
  • binding формы и серверная валидация;
  • базовый поток EF Core и миграций;
  • разницу между серверным рендерингом и API-подходом.

Серия MVC — приложение MvcMovie​

Начните работу с ASP.NET Core MVC — первый шаг серии: проект MvcMovie, .NET 10, шаблон MVC без top-level statements (удобно при копировании кода из статей).

Что даёт серия​

К концу цикла — приложение каталога фильмов с CRUD, EF Core, поиском и валидацией. Навыки:

  • создать и запустить MVC-проект (CTRL+F5, HTTPS dev-сертификат);
  • добавить модель и scaffolding;
  • подключить БД (SQL Server Express / SQLite в следующих частях);
  • поиск и проверка данных.

Пример на GitHub.

Порядок частей серии​

№ТемаURL (view=aspnetcore-10.0)
1Создание приложенияstart-mvc
2Controller и Viewsadding-controller
3Представленияadding-view
4Модельadding-model
5База данныхworking-with-sql
6Controller methodscontroller-methods-views
7Поискsearch
8Валидацияvalidation

Требования: Visual Studio 2022 с рабочей нагрузкой "ASP.NET и веб-разработка" или VS Code + .NET SDK. Имя проекта MvcMovie и регистр namespace должны совпадать с примерами в статьях.

После части 1 в энциклопедии закрепите маршрутизацию и контроллеры (разделы про MVC и routing).

Что проверить на практике после серии MVC​

  1. Настроить собственный маршрут для контроллера и проверить URL-генерацию.
  2. Добавить валидацию модели и посмотреть ModelState.
  3. Подключить логирование запросов и исключений.
  4. Сгенерировать OpenAPI/Swagger и проверить корректность контрактов.

Docker — legacy ASP.NET MVC (.NET Framework)​

Перенос приложений ASP.NET MVC в контейнеры Windows — отдельный сценарий для ASP.NET MVC на .NET Framework (IIS внутри образа Windows), не для ASP.NET Core на Linux.

АспектASP.NET Core в DockerLegacy MVC в Docker (статья)
СтекKestrel / multi-stage Linuxmcr.microsoft.com/dotnet/framework/aspnet:4.8
Публикацияdotnet publishПрофиль Visual Studio → bin\Release\PublishOutput
Точка входаENTRYPOINT в DockerfileIIS в базовом образе
Хост ОСLinux / WindowsКонтейнеры Windows (Docker Desktop → Switch to Windows containers)

Шаги из учебника​

  1. Publish — пользовательский профиль, целевая папка bin\Release\PublishOutput, включить предкомпиляцию представлений при публикации.
  2. Dockerfile — базовый образ Framework, COPY ./bin/Release/PublishOutput/ /inetpub/wwwroot.
  3. Сборка: docker build -t mvcrandomanswers .
docker build -t mvcrandomanswers .
  1. Запуск: docker run -d --name randomanswers mvcrandomanswers (порт 80 в образе по умолчанию).
docker run -d --name randomanswers mvcrandomanswers
  1. Проверка: http://localhost в браузере; остановка: docker stop randomanswers, удаление: docker rm randomanswers.
docker stop randomanswers

Готовый пример.

Для новых проектов используйте Docker с ASP.NET Core и главу Приложение с S3, PostgreSQL и ASP.NET Core Web API. Статья про Framework MVC нужна при сопровождении корпоративных монолитов на IIS.

Типичные ошибки​

  • Путать хаб Core и статью про Framework MVC — разные runtime, образы и Dockerfile.
  • Пропустить ASP.NET - фреймворк для веб-приложений и сразу учебник — непонятны middleware, DI и отличие API от страничного UI.
  • Top-level statements — в сериях Razor Pages и MVC для VS отключайте "интервал верхнего уровня", иначе расходятся Program.cs и примеры.
  • Сразу MVC и Razor Pages — выберите одну серию; вторая пойдёт быстрее после первой.
  • Только чтение без dotnet run — после Первая программа на ASP.NET Core соберите RazorPagesMovie или MvcMovie локально.

Дальше​

Итоги​

Официальная документация ASP.NET Core 10 — хаб + серия Razor Pages (старт для новичков) или MVC + развёртывание. Энциклопедия даёт архитектуру и шпаргалку; Learn — пошаговую практику и актуальные версии API. Legacy Docker для Framework MVC держите отдельно от Core-контейнеров на Linux.

Основа по протоколу

Базовый разбор HTTP и HTTPS находится в отдельной статье — HTTP как основа веб-интеграций.

В подборках​

Статья входит в тематические подборки и блок "С чего начать?" на главной. Соседние шаги того же маршрута:

Веб-разработка — ASP.NET - фреймворк для веб-приложений, Приложение с S3, PostgreSQL и ASP.NET Core Web API, Веб-разработка и API на C#, Python — о разделе, C# — о разделе, Веб-разработка и REST API на Python.

Содержание