Руководство. Начало работы со Razor страницами в ASP.NET Core

Автор: Рик Андерсон (Rick Anderson)

В этом первом руководстве серии приводятся основные сведения о веб-приложении Razor Pages в ASP.NET Core.

Дополнительные сведения, предназначенные для разработчиков, которые знакомы с контроллерами и представлениями, см. в статье Введение в Razor Pages. Общие сведения см. в разделе Entity Framework Core для начинающих.

Если вы новичок в разработке на ASP.NET Core и не знаете, какое решение для пользовательского веб-интерфейса подойдет вам, см. статью Выбор пользовательского интерфейса ASP.NET Core.

В конце этого руководства у вас будет Razor веб-приложение Pages, которое управляет базой данных фильмов.

Необходимые компоненты

Visual Studio

• Visual Studio 2022 с рабочей нагрузкой ASP.NET и веб-разработка.

  

Visual Studio Code

• Visual Studio Code
• Комплект средств разработки C# для Visual Studio Code
• Пакет SDK для .NET 9.0

Вы можете следовать инструкциям Visual Studio Code в macOS, Linux или Windows. Изменения могут потребоваться при использовании интегрированной среды разработки (IDE), отличной от Visual Studio Code.

Создание веб-приложения Razor Pages

Visual Studio

• Запустите Visual Studio и выберите новый проект.

• В диалоговом окне "Создание проекта" выберите ASP.NET Core Web App (RazorPages)>Next.

• В диалоговом окне Настроить новый проект введите RazorPagesMovie в поле Имя проекта. Важно присвоить проекту RazorPagesMovie, включая сопоставление прописной буквы, поэтому пространства имен будут соответствовать при копировании и вставке примера кода.

• Выберите Далее.

• В диалоговом окне Дополнительные сведения выполните следующие действия.

  • Выберите .NET 9.0.
  • Убедитесь, что не используйте операторы верхнего уровня, снятые.

• Нажмите кнопку создания.

  

  Создается следующий начальный проект:

  

Альтернативные подходы к созданию проекта см. в статье Создание проекта в Visual Studio.

Visual Studio Code

В этом руководстве предполагается, что вы умеете работать с VS Code. Дополнительные сведения см. в статье Начало работы с VS Code.

• Выберите новый терминал в меню терминала , чтобы открыть интегрированный терминал.

• Перейдите в каталог cd, в котором будет находиться проект.

• Выполните следующие команды:

  dotnet new webapp -o RazorPagesMovie
  code -r RazorPagesMovie
  

  Команда dotnet new создает новый проект Razor Pages в папке RazorPagesMovie.

  Команда code открывает папку RazorPagesMovie в текущем экземпляре Visual Studio Code.

Visual Studio Code может отобразить диалоговое окно с запросом: доверяете авторам файлов в этой папке?

• Если вы доверяете всем файлам в родительской папке, выберите "Доверять авторам всех файлов" в родительской папке.
• Выберите "Да", я доверяю авторам , так как папка проекта содержит файлы, созданные .NET.
• Когда Visual Studio Code запрашивает добавление ресурсов для сборки и отладки проекта, нажмите кнопку "Да". Если Visual Studio Code не предлагает добавлять ресурсы сборки и отладки, выберите представление>палитры команд и введите ".NET" в поле поиска. В списке команд выберите .NET: Generate Assets for Build and Debug команду.

Visual Studio Code добавляет папку .vscode с созданными и launch.json файламиtasks.json.

Выполнить приложение

Visual Studio

Выберите RazorPagesMovie в Обозреватель решений и нажмите клавиши CTRL+F5, чтобы запустить приложение без отладчика.

Visual Studio отображает следующее диалоговое окно, если проект еще не настроен для использования SSL:

Выберите Да, чтобы сделать SSL-сертификат IIS Express доверенным.

Отобразится следующее диалоговое окно.

Выберите Да, если согласны доверять сертификату разработки.

Сведения о доверии к браузеру Firefox см. в разделе Ошибка сертификата браузера Firefox SEC_ERROR_INADEQUATE_KEY_USAGE.

Visual Studio:

• Запускает приложение, которое запускает сервер Kestrel.
• Запускает браузер по умолчанию по адресу https://localhost:<port>, который отображает пользовательский интерфейс приложений. <port> — случайный порт, назначенный при создании приложения.

Закройте окно браузера.

Visual Studio Code

• Настройте доверие сертификату разработки HTTPS с помощью следующей команды:

  dotnet dev-certs https --trust
  

  Приведенная выше команда отображает следующее диалоговое окно, если сертификат не был ранее доверенным:

  

• Выберите Да, если согласны доверять сертификату разработки.

  Дополнительные сведения см. в разделе "Доверие" в разделе сертификатов разработки ASP.NET Core HTTPS статьи "Принудительное применение SSL ".

Сведения о доверии к браузеру Firefox см. в разделе Ошибка сертификата браузера Firefox SEC_ERROR_INADEQUATE_KEY_USAGE.

В Visual Studio Code нажмите клавиши F5 (Windows) или +(macOS), чтобы запустить приложение без отладки.

В командной строке выбора отладчика выберите C#.

В командной строке "Выбрать запуск конфигурации" выберите C#: RazorPagesMovie [https] RazorPagesMovie.

Браузер по умолчанию запускается со следующим URL-адресом: https://localhost:<port> где <port> случайным образом создается номер порта.

Закройте окно браузера.

В Visual Studio Code в меню "Запуск" выберите "Остановить отладку" или нажмите клавиши SHIFT+F5, чтобы остановить приложение.

Анализ файлов проекта

В разделах ниже приведен обзор основных папок и файлов проекта, с которыми вы будете работать в последующих учебниках.

Папка Pages

Содержит страницы Razor и вспомогательные файлы. Каждая страница Razor — это пара файлов.

• Файл .cshtml с разметкой HTML и кодом C# использует синтаксис Razor.
• .cshtml.cs Файл с кодом C#, который обрабатывает события страницы.

Имена вспомогательных файлов начинаются с символа подчеркивания. Например, _Layout.cshtml файл настраивает элементы пользовательского интерфейса, общие для всех страниц. _Layout.cshtml настраивает меню навигации в верхней части страницы и уведомление об авторских правах в нижней части страницы. Подробные сведения см. в статье Макет в ASP.NET Core.

Папка wwwroot

Содержит статические ресурсы, такие как HTML-файлы, файлы JavaScript и CSS-файлы. Подробные сведения см. в статье Статические файлы в ASP.NET Core.

appsettings.json

Содержит данные конфигурации, например строки подключения. Дополнительные сведения см. в разделе Конфигурация в ASP.NET Core.

Program.cs

Содержит следующий код:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();

var app = builder.Build();

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();

app.UseRouting();

app.UseAuthorization();

app.MapStaticAssets();
app.MapRazorPages();

app.Run();

Следующие строки кода в этом файле создают WebApplicationBuilder предварительно настроенные значения по умолчанию, добавляют Razor поддержку Pages в контейнер внедрения зависимостей (DI) и создают приложение:

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.
builder.Services.AddRazorPages();

var app = builder.Build();

Страница со сведениями об исключении для разработчика включена по умолчанию и содержит полезную информацию об исключениях. Рабочие приложения не следует запускать в режиме разработки, поскольку на странице со сведениями об исключении для разработчика может находиться конфиденциальная информация.

В следующем коде для конечной точки устанавливаются исключения /Error и включается протокол HSTS, если приложение не запущено в режиме разработки:

// Configure the HTTP request pipeline.
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

Например, приведенный выше код выполняется, когда приложение находится в рабочем или тестовом режиме. Дополнительные сведения см. в статье Использование нескольких сред в ASP.NET Core.

Следующий код включает различное ПО промежуточного слоя:

• app.UseHttpsRedirection();: перенаправляет все запросы HTTP на HTTPS.
• app.UseRouting();: добавляет соответствие маршрута в конвейер ПО промежуточного слоя. Подробные сведения см. в статье Маршрутизация в ASP.NET Core.
• app.UseAuthorization();: разрешает пользователю доступ к защищенным ресурсам. Это приложение не использует авторизацию, поэтому эту строку можно удалить.
• app.MapRazorPages();: настраивает маршрутизацию конечных точек для Razor Pages.
• app.MapStaticAssets();. Оптимизация доставки статических ресурсов в приложении, таких как HTML, CSS, изображения и JavaScript. Дополнительные сведения см. в статье "Новые возможности" в ASP.NET Core 9.0.
• app.Run();: запускает приложение.

Устранение неполадок с завершенным примером

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

Следующие шаги

Далее: добавление модели