ASP.NET 教程 | Hello World 5 分钟

介绍

目标

安装 .NET 并创建首个 Web 应用程序。

先决条件

无。

完成时间

5 分钟

方案

Web 应用在网页上显示“Hello, World!”消息。

本地预配向导和预配代理。

若要开始生成 .NET 应用，请下载并安装 .NET SDK (软件开发工具包)。

下载 .NET 7 SDK (64 位)
32 位下载 | Arm64 下载

你需要在较旧版本的 Windows 上安装其他依赖项。有关详细信息，请参阅 Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2。

检查是否已正确安装所有内容

安装完成后，打开新的命令提示符并运行以下命令:

Command prompt

dotnet

如果安装成功，则应该会看到类似于以下内容的输出:

Command prompt

Usage: dotnet [options]
Usage: dotnet [path-to-application]

Options:
-h|--help         Display help.
--info            Display .NET information.
--list-sdks       Display the installed SDKs.
--list-runtimes   Display the installed runtimes.

path-to-application:
The path to an application .dll file to execute.

如果一切正常，请选择下面的继续按钮以转到下一步。

遇到错误?

如果收到“未将 “dotnet” 识别为内部或外部命令”错误，请确保已打开新命令提示符。如果无法解决该问题，则使用“我遇到了问题”按钮来获取解决问题的帮助。

创建应用

在命令提示符下，运行以下命令以创建应用:

Command prompt

dotnet new webapp -o MyWebApp --no-https -f net7.0

此命令是什么意思?

dotnet new 命令会新建一个应用程序。

webApp 参数选择创建应用时要使用的模板。
-o 参数会创建名为 MyWebApp 的目录，用于存储应用。
--no-https 标记指定不启用 HTTPS。
-f 参数指示你正在创建 .NET 7 应用程序。

创建了哪些文件?

已在 MyWebApp 目录中创建多个文件，以为你提供可供运行的简单 Web 应用程序。

Program.cs 包含应用启动代码和中间件配置。
Pages 目录包含应用程序的一些示例网页。
MyWebApp.csproj 会定义一些项目设置，例如要面向的 .NET SDK 版本。
Properties 目录中的 launchSettings.json 文件为本地开发环境定义不同的配置文件设置。创建项目时会自动分配 5000-5300 之间的端口号并将其保存在此文件上。

选择下面的继续按钮以转到下一步。

遇到错误?

如果收到类似于“模版 "ASP.NET Core Web App" 无法创建。无法创建模版。详细信息: 对路径 "C:\Windows\System32\MyWebApp" 的访问被拒绝”的消息，请将当前目录更改为有权在其中新建文件夹的目录，并尝试再次运行该命令。

如果在尝试创建项目时 Windows 找不到 SDK，且你确定已安装 SDK，则计算机可能存在 PATH 环境变量问题。请参阅此 Stack Overflow 帖子，获取如何诊断并解决此问题的说明。

如果无法解决遇到的问题，请选择下面的 我遇到了问题 按钮，以获取解决问题的帮助。

运行应用

在命令提示符中，导航到在上一步中新建的目录:

Command prompt

cd MyWebApp

然后，运行以下命令:

Command prompt

dotnet watch

应看到与以下内容类似的输出:

Command prompt

watch : Hot reload enabled. For a list of supported edits, see https://aka.ms/dotnet/hot-reload. Press "Ctrl + R" to restart.
watch : Building...
Determining projects to restore...
All projects are up-to-date for restore.
MyWebApp -> C:\Projects\MyWebApp\bin\Debug\net6.0\MyWebApp.dll
watch : Started
info: Microsoft.Hosting.Lifetime[14]
Now listening on: http://localhost:5055
info: Microsoft.Hosting.Lifetime[0]
Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
Content root path: C:\Projects\MyWebApp\

dotnet watch 命令将生成并启动应用，然后在每次更改代码时更新正在运行的应用。可以选择Ctrl+C，以随时停止应用。

等待应用显示正在侦听 http://localhost:<port number> 并等待浏览器在该地址启动。

恭喜你已生成并运行自己第一个 .NET Web 应用!

编辑代码

在任意文本编辑器中打开位于 Pages 目录中的 Index.cshtml 文件。

注意: 请确保正在打开 cshtml 页面，而非 cshtml.cs 页面。根据系统配置方式，Windows 可能会隐藏文件扩展名。

将所有代码替换为以下内容，然后保存该文件。突出显示的代码行会显示将执行的更改。

Pages/Index.cshtml

@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <h1>Hello, world!</h1>
    <p>The time on the server is @DateTime.Now</p>
</div>

保存此更改后，dotnet watch 命令会将更改应用到正在运行的应用并在浏览器中进行刷新，以便可以在正在运行的应用中看到更改。

后续步骤

现在，你已掌握了基础知识，请继续使用 Microsoft Learn 上的此自引导式学习模块通过 Razor Pages 生成首个 ASP.NET 应用，你将在其中生成披萨店库存应用。

Microsoft Learn: 使用 ASP.NET Core 创建 Web UI

使用 .NET 进行更多 Web 开发

浏览使用 .NET 进行 Web 开发系列的 6 部分简介! 在这里，你将生成出色的项目，并了解有关 Razor Pages、最小 API、Blazor 等的所有信息。

使用 .NET 进行 Web 开发简介

你可能还会关注...

Web 学习资料

浏览我们的完整视频、教程、文档列表以及更多内容

生成 REST API

使用 ASP.NET 创建 REST API

获取编辑器

使用正确的 .NET 编辑器获取 .NET 开发工具安装

ASP.NET 教程 - Hello World 5 分钟

介绍

目标

先决条件

完成时间

方案

本地预配向导和预配代理。

检查是否已正确安装所有内容

遇到错误?

创建应用

此命令是什么意思?

创建了哪些文件?

遇到错误?

运行应用

编辑代码

后续步骤

使用 .NET 进行更多 Web 开发

Web 学习资料

生成 REST API

获取编辑器

报告问题

提供反馈