Документация по ASP.NET | Microsoft Learn
Узнайте, как с помощью ASP.NET Core создавать быстрые и безопасные кроссплатформенные или облачные веб-приложения и службы. Изучайте руководства, примеры кода, основные понятия, справочник по API и многое другое.
Начало работы
Создание приложения ASP.NET Core на любой платформе за 5 минут
Общие сведения
Обзор ASP.NET Core
Скачать
Скачать .NET
Новое
Новые возможности в документации по ASP.NET Core
Начало работы
Создание первого пользовательского веб-интерфейса
Начало работы
Создание первого веб-API
Начало работы
Создание первого веб-приложения в реальном времени
Общие сведения
Документация по ASP.
Разработка приложений ASP.NET Core
Выбирайте между интерактивными веб-приложениями, веб-API, приложениями на базе шаблонов MVC, приложениями реального времени и многим другим.
Интерактивные приложения Blazor на стороне клиента
Применяйте в разработке взаимозаменяемые компоненты пользовательского интерфейса, обеспечивающие производительность практически на уровне внутренних компонентов браузера за счет WebAssembly.
Приложения API HTTP
Разработка служб HTTP с помощью ASP.NET Core
Ориентированный на страницы веб-интерфейс с Razor Pages
Разрабатывайте основанные на страницах веб-приложения с четким разделением ответственностей.
Ориентированный на страницы веб-интерфейс с MVC
Разрабатывайте веб-приложения с помощью шаблона проектирования MVC (модель — представление — контроллер).
Веб-приложения реального времени с SignalR
Добавьте в свое веб-приложение функции реального времени и используйте код на стороне сервера для мгновенной отправки содержимого.
Приложения удаленного вызова процедур (RPC) — службы gRPC
Разрабатывайте высокопроизводительные службы на базе модели «сначала контракт» с помощью gRPC в ASP.NET Core.
Веб-приложения на основе данных
Создавайте веб-приложения, работающие на основе данных, в ASP.NET Core.
Предыдущие версии платформы ASP.NET
Изучайте обзоры, учебники, основные понятия, архитектуру и справочники по API для предыдущих версий платформы ASP.NET.
Учебные видео по ASP.NET Core
Справочник по API для ASP.NET Core
Размещение и развертывание
Безопасность и идентификация
Глобализация и локализация
Тестирование, отладка и устранение неполадок
Azure и ASP.NET Core
Производительность
Дополнительные функции
Миграция
Architecture
Примите участие в создании документации по ASP.NET Core. Ознакомьтесь с нашим руководством для соавторов.
ASP.NET Core | Начало работы
Данное руководство устарело. Актуальное руководство: Руководство по ASP.NET Core 7
Последнее обновление: 15.12.2020
Для разработки под ASP.NET Core мы можем использовать различный инструментарий. Если нашей рабочей платформой является Windows, то мы можем использовать полнофункциональную среду разработки Visual Studio. Если мы разрабатываем на Mac OS или Linux, то можем использовать расширенный редактор кода Visual Studio Code. Данный редактор также может работать и под Windows. В рамках данного руководства преимущественно будет использоваться среда Visual Studio 2019.
Программу для установки Visual Studio 2019 можно загрузить со страницы https://www.visualstudio.com/downloads/. В данном случае не важно, какой выпуск VS использовать — бесплатный Community или платные Professional или Enterprise. Все эти выпуски имеют встроенные средства для создания приложений на ASP.NET Core. В рамках этого руководства будет использоваться бесплатный выпуск VS 2019 Community.
Итак, загрузим установщик VS 2019 и запустим его. Вначале нам предлагается установить ряд опций. И так как мы будем работать с ASP.NET Core, то выбрать в программе для установке пункт ASP.NET и разработка веб-приложений:
Также при выборе этого пункта в поле справа можно выбрать также необязательные компоненты, которые будут устанавливаться вместе с ASP.NET. Можно выбрать все компоненты.
Кроме того, чуть ниже также в программе установщика нам надо выбрать другой пункт Кроссплатформенная разработка .NET Core:
Отметив все необходимые нам опции, выполним установку Visual Studio.
После установки откроем Microsoft Visual Studio 2019 и при создании проекта выберем пункт ASP.NET Core Web Application — тип проекта для создания веб-приложения ASP.NET Core:
На следующем шаге дадим какое-нибудь имя проекту, например, HelloApp, и определим для него местоположение на жестком диске:
После этого отобразится окно выбора шаблона нового приложения:
Здесь нам доступно несколько типов проектов:
ASP. NET Core Empty: пустой шаблон с самой минимальной функциональностью для создания приложений с нуля
ASP.NET Core Web API: проект веб-приложения, который использует архитектуру REST для создания веб-сервиса
ASP.NET Core Web App: проект, который для обработки запросов по умолчанию использует Razor Pages
ASP.NET Core Web App(Model-View-Controller): проект, который использует архитектуру MVC
ASP.NET Core with Angular: проект, предназначенный специально для работы с Angular 2+.
ASP.NET Core with React.js: проект, который использует React.JS
ASP.NET Core with React.js and Redux: проект, который использует React.JS и Redux
Кроме того, здесь мы можем указать версию ASP.NET Core в выпадающем списке, но в данном случае оставим значение по умолчанию — ASP.NET Core 5.0.
Также здесь можно указать тип аутентификации, который по умолчанию используется в проекте, и подключить контейнер Docker.
Также здесь есть флажок «Configure for HTTPS». При установке этого флажка проект при отладке и тестировании по умолчанию будет запускаться по протоколу HTTPS. В данном случае установка и неустановка этого флажка не имеет значения. Кроме того, даже если мы установили эту отметку, то впоследствии через свойства проекта можно отменить запуск через HTTPS или, наоборот, заново установить.
Среди этих шаблонов выберем ASP.NET Core Empty, все остальные значения оставим по умолчанию и нажмем на кнопку ОК. И Visual Studio создает новый проект:
Структура проекта ASP.NET Core
Connected Services: подключенные сервисы из Azure
Dependencies: все добавленные в проект пакеты и библиотеки, иначе говоря зависимости
Properties: узел, который содержит некоторые настройки проекта. В частности, в файле launchSettings.json описаны настройки запуска проекта, например, адреса, по которым будет запускаться приложение.
appsettings.json: файл конфигурации проекта в формате json
Program.cs: главный файл приложения, с которого и начинается его выполнение. Код этого файла настривает и запускает веб-хост, в рамках которого разворачивается приложение
Startup.cs: файл, который определяет класс Startup и который содержит логику обработки входящих запросов
Данная структура, конечно, не представляет проект полнофункционального приложения. И если мы запустим проект, то в браузере увидим только строку «Hello World!», которая отправляется в ответ клиенту с помощью класса Startup:
При создании других типов проектов ASP.NET структура будет отличаться, соответственно начальный проект будет иметь больше функционала, однако это тот каркас, от которого мы можем отталкиваться, добавляя в него какие-то свои файлы и папки.
НазадСодержаниеВперед
Что такое ASP.NET? | .NET
ASP.NET — это веб-инфраструктура с открытым исходным кодом, созданная Microsoft для создания современных веб-приложений и служб с помощью .NET.
ASP.NET является кроссплатформенным и работает в Linux, Windows, macOS и Docker.
Платформа .NET
.NET — это платформа для разработчиков, состоящая из инструментов, языков программирования и библиотек для создания различных типов приложений.
Базовая платформа предоставляет компоненты, применимые ко всем типам приложений. Дополнительные платформы, такие как ASP.NET, расширяют .NET компонентами для создания определенных типов приложений.
Вот некоторые вещи, включенные в платформу .NET:
- Языки программирования C#, F# и Visual Basic
- Базовые библиотеки для работы со строками, датами, файлами/операциями ввода-вывода и т. д.
- Редакторы и инструменты для Linux, Windows, macOS и Docker
Узнайте больше о платформе .NET
ASP.NET расширяет .NET
ASP.NET расширяет платформу .NET с помощью инструментов и библиотек специально для создания веб-приложений.
Вот некоторые вещи, которые ASP.NET добавляет к платформе .NET:
- Базовая платформа для обработки веб-запросов на C# или F#
- Синтаксис шаблонов веб-страниц , известный как Razor, для создания динамических веб-страниц с использованием C#
- Библиотеки для распространенных веб-шаблонов , например Model View Controller (MVC)
- Система аутентификации , включающая библиотеки, базу данных и страницы шаблонов для обработки входов в систему, включая многофакторную аутентификацию и внешнюю аутентификацию с помощью Google, Twitter и т. д.
- Расширения редактора для подсветки синтаксиса, завершения кода и других функций, специально предназначенных для разработки веб-страниц
Внутренний код
При использовании ASP.NET ваш внутренний код, такой как бизнес-логика и доступ к данным, написан с использованием C#, F# или Visual Basic.
Поскольку ASP.NET расширяет .NET, вы можете использовать обширную экосистему пакетов и библиотек, доступную всем разработчикам .NET. Вы также можете создавать свои собственные библиотеки, которые совместно используются любыми приложениями, написанными на платформе .NET.
Динамические страницы с использованием C#, HTML, CSS и JavaScript
Razor предоставляет синтаксис для создания динамических веб-страниц с использованием HTML и C#. Ваш код C# оценивается на сервере, и результирующий HTML-контент отправляется пользователю.
Код, который выполняется на стороне клиента, написан на JavaScript. ASP.NET интегрируется с платформами JavaScript и включает предварительно настроенные шаблоны для платформ одностраничных приложений (SPA), таких как React и Angular.
100 000+ Вклад OSS 3700+ Авторы компании OSS
Открытый исходный код
Как и остальная часть .NET, ASP.NET является открытым исходным кодом на GitHub. .NET насчитывает более 100 000 вкладов, и 3700 компаний уже внесли свой вклад.
Узнайте больше о .NET и открытом исходном коде
Linux, Windows, macOS и Docker
Приложения ASP.NET можно разрабатывать и запускать в Linux, Windows, macOS и Docker.
Семейство продуктов Visual Studio содержит инструменты для создания приложений .NET в любой операционной системе. Существуют также инструменты командной строки и расширения для многих популярных редакторов.
Узнайте об инструментах для . NET
Страницы, API, режим реального времени и микросервисы
ASP.NET позволяет создавать множество типов веб-приложений, включая веб-страницы, REST API, микросервисы и концентраторы, которые передают контент в реальном времени подключенным клиентам.
Что такое ASP.NET Core?
Если вы используете ASP.NET, вы скоро столкнетесь с термином ASP.NET Core.
ASP.NET Core — это кроссплатформенная версия ASP.NET с открытым исходным кодом. Вы должны использовать ASP.NET Core для всех новых приложений. Все руководства на этом сайте используют ASP.NET Core.
Версии ASP.NET только для Windows, существовавшие до ASP.NET Core, обычно называются просто ASP.NET. Большинство инноваций происходит в ASP.NET Core, но другие версии продолжают получать небольшие обновления и исправления ошибок.
Узнайте больше об ASP.NET Core
Учебники по ASP.
NET | Microsoft УзнайтеРедактировать
Твиттер LinkedIn Фейсбук Электронная почта
- Статья
- 4 минуты на чтение
Для разработки новых веб-приложений мы рекомендуем Razor Pages. Дополнительные сведения см. в статье Начало работы с Razor Pages.
Доступны следующие пошаговые руководства по разработке приложений ASP.NET.
Примечание
Ищете руководства по ASP.NET Core? Найдите их здесь.
Веб-формы
- Редактирование кода Веб-формы ASP.NET в Visual Studio 2013
- Использование инспектора страниц в Visual Studio 2012
- Привязка модели и веб-формы в Visual Studio 2013
- Устойчивость подключения к веб-формам ASP. NET и перехват команд
- Создание безопасного приложения ASP.NET Web Forms с регистрацией пользователя, подтверждением по электронной почте и сбросом пароля (C#)
- Создание приложения веб-форм ASP.NET с двухфакторной аутентификацией SMS (C#)
- Использование асинхронных методов в ASP.NET 4.5
- Веб-развертывание ASP.NET с использованием Visual Studio
- ASP.NET 4 — введение в корпоративное развертывание
- ASP.NET 4 — корпоративное развертывание, серия 1
- ASP.NET 4 — Enterprise Deployment Series 2 Настройка серверов
- ASP.NET 4 — Enterprise Deployment Series 3 Настройка TFS
- ASP.NET 4 — Enterprise Deployment Series 4 Расширенные темы
- ASP.NET 4 — Tailspin Spyworks
- ASP.NET 4 — начало работы с Entity Framework 4 и веб-формами
- ASP.NET 4 — продолжение работы с Entity Framework 4 и веб-формами
- ASP.NET 4 — веб-развертывание с SQL Server Compact с использованием Visual Studio
MVC
- Использование инспектора страниц в ASP. NET MVC
- Создание приложения ASP.NET MVC 5 с Facebook, Twitter, LinkedIn и входом Google OAuth3 (C#)
- Создание безопасного веб-приложения ASP.NET MVC 5 с входом в систему, подтверждением электронной почты и сбросом пароля (C#)
- Приложение ASP.NET MVC 5 с двухфакторной аутентификацией по SMS и электронной почте
- Предотвращение XSRF/CSRF в ASP.NET MVC и веб-страницах
- Предотвращение атак с открытым перенаправлением (C#)
- Миграция приложений ASP.NET MVC в контейнеры Windows
- Профилируйте и отлаживайте приложение ASP.NET MVC с помощью Glimpse
- Использование асинхронных методов в ASP.NET MVC 4
- Как обновить проект ASP.NET MVC 4 и веб-API до ASP.NET MVC 5 и веб-API 2
Веб-API
- Начало работы с веб-API 2 (C#)
- Использование веб-API с веб-формами ASP.NET
- Создание справочных страниц веб-API
- Практическое занятие: Создание одностраничного приложения (SPA) с помощью веб-API ASP. NET и Angular.js
- Создайте REST API с маршрутизацией атрибутов в веб-API 2
- Использование веб-API 2 с Entity Framework 6
- Вызов веб-API из приложения Windows Phone 8 (C#)
- OData v4
- OData v3
- Трассировка в веб-API 2
- Веб-API модульного тестирования 2
- Контроллеры модульного тестирования в ASP.NET Web API 2
- Имитация Entity Framework при модульном тестировании веб-API 2
- Устранение ошибок HTTP 405 после публикации приложений Web API 2
- Защита веб-API с помощью отдельных учетных записей в веб-API 2.2
- Внешние службы проверки подлинности с веб-API (C#)
- Включение запросов между источниками в веб-API 2
- Использование OWIN для самостоятельного размещения веб-API 2
- Host Web API 2 в рабочей роли Azure
- Внедрение зависимостей в веб-API 2
- Вызов веб-API из клиента .NET (C#)
- Отправка данных HTML-формы в веб-API: данные формы с URL-адресом
- Отправка данных формы HTML в веб-API: загрузка файла и составной MIME
Веб-страницы
- Программные веб-страницы ASP. NET в Visual Studio
- Отправка электронной почты с вашего сайта
- Добавление социальных сетей на ваш сайт
- Знакомство с веб-страницами ASP.NET
- Создание читаемых URL-адресов на сайтах веб-страниц ASP.NET
- Работа с формами
- Проверка ввода пользователя на сайтах веб-страниц ASP.NET
- Создание единообразного образа
- Настройка поведения всего сайта
- Работа с изображениями
- Работа с видео
- Создание и использование помощника на сайте веб-страниц ASP.NET
- Установка помощника
- Twitter Helper с веб-страницами ASP.NET
- Отображение карт на сайте веб-страниц ASP.NET
- Рендеринг сайтов веб-страниц ASP.NET для мобильных устройств
- Работа с данными
- Отображение данных на диаграмме
- Работа с файлами
- Введение в отладку
- Добавление безопасности и членства
- Включение входа с внешних сайтов на сайт веб-страниц ASP. NET
- Использование CAPTCHA для предотвращения использования автоматизированными программами (ботами) вашего веб-сайта ASP.NET
- Кэширование для повышения производительности вашего веб-сайта
- Анализ трафика
- Объединение и минимизация ресурсов на сайте веб-страниц ASP.NET (Razor)
- Учебное пособие. Начало работы с SignalR 2 Учебник
- . Начало работы с SignalR 2 и MVC 5
- Учебное пособие: высокочастотный сигнал в реальном времени с SignalR 2 Учебное пособие по
- . Трансляция сервера с помощью SignalR 2
- Практическое занятие: Веб-приложения реального времени с SignalR
- Модульное тестирование приложений SignalR
- Включение трассировки SignalR
- Масштабирование SignalR с помощью служебной шины Azure
- Масштабирование SignalR с помощью Redis
- Масштабирование SignalR с SQL Server
- Тестирование плотности соединения SignalR с Crank
- Использование счетчиков производительности SignalR в веб-роли Azure Учебное пособие по
- : SignalR Self-Host
- Использование SignalR с веб-приложениями в службе приложений Azure