Share via

在 Visual Studio for Mac 中创建 Razor Web 应用

  • 项目

重要

根据 Microsoft 的新式生命周期策略，Visual Studio for Mac 计划于 2024 年 8 月 31 日停用。 虽然你可以继续使用 Visual Studio for Mac，但 Mac 上的开发人员还可以使用其他几个选项，例如适用于 VS Code 的新 C# 开发工具包扩展的预览版本。

详细了解支持时间线和替代方案。

本指南介绍如何创建第一个 Razor Web 应用。 若需要更深入的指导，请参阅 ASP.NET Core 中的 Razor Pages 介绍。

Visual Studio for Mac 提供对 Razor 编辑的支持，包括 .cshtml 文件中的 IntelliSense 和语法突出显示 。 Visual Studio 2019 for Mac 8.3+ 中的新增功能可在 Razor 文件中拥有上下文感知 IntelliSense，从而能接收与当前在文档中编辑的语言相匹配的 IntelliSense。

Razor editing in Visual Studio for Mac

创建新的 Razor 项目

  1. 在欢迎屏幕上，选择“新建”以创建新项目 ：

    Visual Studio for Mac new project

  2. 在“新建项目”对话框中，转到“.NET Core”>“应用”>“Web 应用程序”，然后选择“下一步”：

    Razor project template

  3. 选择你的 .NET Core 目标框架（建议使用 2.2 或更高版本），然后选择“下一步” 。 为项目选择一个名称，并在必要时添加 Git 支持。 选择“创建”来创建项目。

    Razor project name

    Visual Studio for Mac 会在代码布局窗口中打开项目。

  4. 使用 Command+Option+F5 运行该项目，无需调试 。

    Visual Studio 将启动 Kestral，然后打开浏览器转至 https://localhost:5001 并显示第一个 Razor Web 应用。

    Razor web app in Safari

项目剖析

Razor Web 应用包含以下组件。

Pages 文件夹

此文件夹包含项目的网页，以及每个网页的代码隐藏：

  • *.cshtml 文件对应 HTML 标记和 Razor 语法。
  • *.cshtml.cs 文件对应用于处理页面事件的 C# 代码隐藏。

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

启动设置

launchSettings.json 文件包含 IIS 设置、应用程序 URL 和其他相关设置 。

应用设置

appSettings,json 文件包含配置数据，如连接字符串。

有关配置的详细信息，请参阅 ASP.NET 中的配置指南。

wwwroot 文件夹

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

Program.cs

此文件包含程序的入口点。 有关详细信息，请参阅 ASP.NET Core Web 主机。

Startup.cs

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

另请参阅

有关创建 Razor Web 应用的更全面指南，请参阅 ASP.NET Core 中的 Razor Pages 简介。