教程:在 ASP.NET Core 中开始使用 Razor Pages

作者:Rick Anderson

本教程是系列教程中的第一个教程,介绍生成 ASP.NET Core Razor 页面 Web 应用的基础知识。

有关面向熟悉控制器和视图的开发人员的更高级介绍,请参阅 Razor Pages 简介

在本系列结束时,你将拥有一个管理电影数据库的应用。

查看或下载示例代码如何下载)。

在本教程中,你将了解:

  • 创建 Razor 页面 Web 应用。
  • 运行应用。
  • 检查项目文件。

在本教程结束时,你将有一个工作的 Razor Pages Web 应用。在后续教程中,你可以在其基础上进行增强。

Home 或 Index 页

先决条件

创建 Razor 页面 Web 应用

  1. 启动 Visual Studio 并选择“创建新项目”。 有关详细信息,请参阅在 Visual Studio 中新建项目

    从“启动”窗口创建新项目

  2. 在“创建新项目”对话框中,选择“ASP.NET Core Web 应用程序”,然后选择“下一步” 。

    新建 ASP.NET Core Web 应用程序

  3. 在“配置新项目”对话框中,为“项目名称”输入 RazorPagesMovie。 请务必将项目命名为“RazorPagesMovie”(包括匹配大小写),这样在复制和粘贴代码时命名空间就会匹配。

  4. 选择“创建” 。

    新建 ASP.NET Core Web 应用程序

  5. 在“创建新的 ASP.NET Core Web 应用程序”对话框中,选择:

    1. 下拉列表中的“.NET Core”和“ASP.NET Core 5.0”。
    2. Web 应用程序
    3. Create

    新建 ASP.NET Core Web 应用程序

    创建以下初学者项目:

    “解决方案资源管理器”

运行应用

  • 按 Ctrl+F5 以在不使用调试程序的情况下运行。

    Visual Studio 会显示以下对话框:

    此项目配置为使用 SSL。 要避免浏览器中出现 SSL 警告,可以选择信任 IIS Express 生成的自签名证书。 要信任 IIS Express SSL 证书吗?

    如果信任 IIS Express SSL 证书,请选择“是”。

    将显示以下对话框:

    安全警告对话

    如果你同意信任开发证书,请选择“是”。

    有关信任 Firefox 浏览器的信息,请参阅 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 证书错误

    Visual Studio 启动 IIS Express 并运行应用。 地址栏显示 localhost:port#,而不是显示 example.com。 这是因为 localhost 是本地计算机的标准主机名。 Localhost 仅为来自本地计算机的 Web 请求提供服务。 Visual Studio 创建 Web 项目时,Web 服务器使用的是随机端口。

检查项目文件

下面是主项目文件夹和文件的概述,将在后续教程中使用。

Pages 文件夹

包含 Razor 页面和支持文件。 每个 Razor 页面都是一对文件:

  • 一个 .cshtml 文件,其中包含使用 Razor 语法的 C# 代码的 HTML 标记。
  • 一个 .cshtml.cs 文件,其中包含处理页面事件的 C# 代码。

支持文件的名称以下划线开头。 例如,_Layout.cshtml 文件可配置所有页面通用的 UI 元素。 此文件设置页面顶部的导航菜单和页面底部的版权声明。 有关详细信息,请参阅 ASP.NET Core 中的布局

wwwroot 文件夹

包含静态资产,如 HTML 文件、JavaScript 文件和 CSS 文件。 有关详细信息,请参阅 ASP.NET Core 中的静态文件

appsettings.json

包含配置数据,如连接字符串。 有关详细信息,请参阅 ASP.NET Core 中的配置

Program.cs

包含应用的入口点。 有关详细信息,请参阅 ASP.NET Core 中的 .NET 通用主机

Startup.cs

包含配置应用行为的代码。 有关详细信息,请参阅 ASP.NET Core 中的应用启动

后续步骤

本教程是系列教程中的第一个教程,介绍生成 ASP.NET Core Razor 页面 Web 应用的基础知识。

有关面向熟悉控制器和视图的开发人员的更高级介绍,请参阅 Razor Pages 简介

在本系列结束时,你将拥有一个管理电影数据库的应用。

查看或下载示例代码如何下载)。

在本教程中,你将了解:

  • 创建 Razor 页面 Web 应用。
  • 运行应用。
  • 检查项目文件。

在本教程结束时,你将有一个工作的 Razor 页面 Web 应用。在后续教程中,你可以在其基础上进行构建。

Home 或 Index 页

先决条件

创建 Razor 页面 Web 应用

  • 从 Visual Studio“文件”菜单中选择“新建”>“项目”。

  • 创建新的 ASP.NET Core Web 应用程序,然后选择“下一步”。 新建 ASP.NET Core Web 应用程序

  • 将项目命名为“RazorPagesMovie”。 请务必将项目命名为“RazorPagesMovie”,这样在复制和粘贴代码时命名空间就会匹配。 新建 ASP.NET Core Web 应用程序

  • 在下拉列表中选择“ASP.NET Core 3.1”,然后依次选择“Web 应用程序”和“创建” 。

新建 ASP.NET Core Web 应用程序

创建以下初学者项目:

“解决方案资源管理器”

运行应用

  • 按 Ctrl+F5 以在不使用调试程序的情况下运行。

    Visual Studio 会显示以下对话框:

    此项目配置为使用 SSL。 要避免浏览器中出现 SSL 警告,可以选择信任 IIS Express 生成的自签名证书。 要信任 IIS Express SSL 证书吗?

    如果信任 IIS Express SSL 证书,请选择“是”。

    将显示以下对话框:

    安全警告对话

    如果你同意信任开发证书,请选择“是”。

    有关信任 Firefox 浏览器的信息,请参阅 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 证书错误

    Visual Studio 启动 IIS Express 并运行应用。 地址栏显示 localhost:port#,而不是显示 example.com。 这是因为 localhost 是本地计算机的标准主机名。 Localhost 仅为来自本地计算机的 Web 请求提供服务。 Visual Studio 创建 Web 项目时,Web 服务器使用的是随机端口。

检查项目文件

下面是主项目文件夹和文件的概述,将在后续教程中使用。

Pages 文件夹

包含 Razor 页面和支持文件。 每个 Razor 页面都是一对文件:

  • 一个 .cshtml 文件,其中包含使用 Razor 语法的 C# 代码的 HTML 标记。
  • 一个 .cshtml.cs 文件,其中包含处理页面事件的 C# 代码。

支持文件的名称以下划线开头。 例如,_Layout.cshtml 文件可配置所有页面通用的 UI 元素。 此文件设置页面顶部的导航菜单和页面底部的版权声明。 有关详细信息,请参阅 ASP.NET Core 中的布局

wwwroot 文件夹

包含静态文件,如 HTML 文件、JavaScript 文件和 CSS 文件。 有关详细信息,请参阅 ASP.NET Core 中的静态文件

appSettings.json

包含配置数据,如连接字符串。 有关详细信息,请参阅 ASP.NET Core 中的配置

Program.cs

包含程序的入口点。 有关详细信息,请参阅 ASP.NET Core 中的 .NET 通用主机

Startup.cs

包含配置应用行为的代码。 有关详细信息,请参阅 ASP.NET Core 中的应用启动

后续步骤

这是系列中的第一个教程。 本系列介绍构建 ASP.NET Core Razor 页面 Web 应用的基础知识。

有关面向熟悉控制器和视图的开发人员的更高级介绍,请参阅 Razor Pages 简介

在本系列结束时,你将拥有一个管理电影数据库的应用。

查看或下载示例代码如何下载)。

在本教程中,你将了解:

  • 创建 Razor 页面 Web 应用。
  • 运行应用。
  • 检查项目文件。

在本教程结束时,你将有一个工作的 Razor 页面 Web 应用。在后续教程中,你可以在其基础上进行构建。

Home 或 Index 页

先决条件

警告

如果使用 Visual Studio 2017,请参阅 dotnet/sdk 问题 #3124,以了解无法与 Visual Studio 一起使用的 .NET Core SDK 版本的信息。

创建 Razor 页面 Web 应用

  • 从 Visual Studio“文件”菜单中选择“新建”>“项目”。

  • 创建新的 ASP.NET Core Web 应用程序,然后选择“下一步”。

    新建 ASP.NET Core Web 应用程序

  • 将项目命名为“RazorPagesMovie”。 请务必将项目命名为“RazorPagesMovie”,这样在复制和粘贴代码时命名空间就会匹配。

    新建 ASP.NET Core Web 应用程序

  • 在下拉列表中选择“ASP.NET Core 2.2”,然后依次选择“Web 应用程序”和“创建” 。

新建 ASP.NET Core Web 应用程序

创建以下初学者项目:

“解决方案资源管理器”

运行应用

  • 按 Ctrl+F5 以在不使用调试程序的情况下运行。

    使用“Ctrl+F5”启动应用(非调试模式)后,可执行代码更改、保存文件、刷新浏览器和查看代码更改等操作。 许多开发人员更喜欢使用非调试模式快速启动应用并查看更改。

    Visual Studio 会显示以下对话框:

    此项目配置为使用 SSL。 要避免浏览器中出现 SSL 警告,可以选择信任 IIS Express 生成的自签名证书。 要信任 IIS Express SSL 证书吗?

    如果信任 IIS Express SSL 证书,请选择“是”。

    将显示以下对话框:

    安全警告对话

    如果你同意信任开发证书,请选择“是”。

    有关信任 Firefox 浏览器的信息,请参阅 Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 证书错误

    Visual Studio 启动 IIS Express 并运行应用。 地址栏显示 localhost:port#,而不是显示 example.com。 这是因为 localhost 是本地计算机的标准主机名。 Localhost 仅为来自本地计算机的 Web 请求提供服务。 Visual Studio 创建 Web 项目时,Web 服务器使用的是随机端口。

  • 在应用的主页上,选择“接受”以同意跟踪。

    此应用不会跟踪个人信息,但项目模板包括许可功能,以防需要它来符合欧盟的一般数据保护条例 (GDPR)

    Home 或 Index 页

    下图展示了提供同意跟踪后的应用:

    Home 或 Index 页

检查项目文件

下面是主项目文件夹和文件的概述,将在后续教程中使用。

Pages 文件夹

包含 Razor 页面和支持文件。 每个 Razor 页面都是一对文件:

  • 一个 .cshtml 文件,其中包含使用 Razor 语法的 C# 代码的 HTML 标记。
  • 一个 .cshtml.cs 文件,其中包含处理页面事件的 C# 代码。

支持文件的名称以下划线开头。 例如,_Layout.cshtml 文件可配置所有页面通用的 UI 元素。 此文件设置页面顶部的导航菜单和页面底部的版权声明。 有关详细信息,请参阅 ASP.NET Core 中的布局

Razor 页面派生自 PageModel。 按照约定,PageModel 派生的类称为 <PageName>Model

wwwroot 文件夹

包含静态文件,如 HTML 文件、JavaScript 文件和 CSS 文件。 有关详细信息,请参阅 ASP.NET Core 中的静态文件

appSettings.json

包含配置数据,如连接字符串。 有关详细信息,请参阅 ASP.NET Core 中的配置

Program.cs

包含程序的入口点。 有关详细信息,请参阅 ASP.NET Core 中的 .NET 通用主机

Startup.cs

包含配置应用行为的代码,例如是否需要同意 cookie。 有关详细信息,请参阅 ASP.NET Core 中的应用启动

其他资源

后续步骤