首页
/ ASP.NET Core 入门教程:从零开始构建第一个Web应用

ASP.NET Core 入门教程:从零开始构建第一个Web应用

2025-07-06 03:50:52作者:凤尚柏Louis

前言

ASP.NET Core 是一个开源的、跨平台的框架,用于构建现代云优化的Web应用。本教程将带领初学者快速上手ASP.NET Core开发,通过简单的步骤创建一个"Hello World"风格的Web应用。

环境准备

在开始之前,请确保你的开发环境满足以下要求:

  • 安装最新版本的.NET SDK(根据你的ASP.NET Core版本选择对应SDK)
  • 一个文本编辑器或IDE(如Visual Studio Code、Visual Studio等)
  • 命令行工具(Windows的CMD/PowerShell,macOS/Linux的Terminal)

创建第一个ASP.NET Core应用

1. 创建项目

打开命令行工具,执行以下命令创建一个新的ASP.NET Core Web应用:

dotnet new webapp --output aspnetcoreapp --no-https

这个命令会:

  • 使用webapp模板创建项目
  • 将项目输出到aspnetcoreapp目录
  • 禁用HTTPS(仅用于开发测试)

2. 项目结构解析

创建完成后,项目目录包含以下关键文件和文件夹:

aspnetcoreapp/
├── Pages/          # Razor页面存放目录
│   ├── Index.cshtml # 首页视图文件
│   └── _ViewStart.cshtml
├── wwwroot/        # 静态资源文件夹
├── appsettings.json # 应用配置文件
└── Program.cs      # 应用启动入口

运行应用

1. 启动应用

进入项目目录并运行应用:

cd aspnetcoreapp
dotnet run

命令执行后,控制台会显示应用监听的端口(通常是5000或随机端口)。

2. 访问应用

打开浏览器,访问控制台显示的URL(如http://localhost:5000),你将看到默认的欢迎页面。

修改Razor页面

1. 编辑首页

让我们自定义首页内容:

  1. 在命令行按Ctrl+C停止应用
  2. 用文本编辑器打开Pages/Index.cshtml
  3. 找到"Learn about"这一行,替换为:
<p>欢迎来到我的第一个ASP.NET Core应用!当前时间: @DateTime.Now</p>

2. 查看修改效果

保存文件后,重新运行应用:

dotnet run

刷新浏览器页面,你将看到包含当前时间的欢迎信息。

核心概念解析

1. Razor页面

Razor是ASP.NET Core的视图引擎,它:

  • 允许在HTML中嵌入C#代码
  • 文件扩展名为.cshtml
  • 支持模型绑定和页面处理程序

2. 中间件管道

ASP.NET Core使用中间件管道处理请求:

  • 每个请求都经过一系列中间件
  • 中间件可以处理请求或将其传递给下一个中间件
  • Program.cs中配置

3. 依赖注入

ASP.NET Core内置依赖注入容器:

  • 通过构造函数注入服务
  • 提高代码可测试性和松耦合

常见问题解答

Q: 如何更改应用监听的端口?

A: 可以在Program.cs中使用UseUrls方法指定端口:

app.Urls.Add("http://localhost:8080");

Q: 如何添加新的页面?

A: 在Pages文件夹下添加新的.cshtml文件即可自动成为可访问的路由。

Q: 为什么我的修改没有生效?

A: ASP.NET Core默认在开发环境下会监控文件变化并自动重新编译,如果未生效,请尝试手动重启应用。

下一步学习建议

完成本教程后,你可以继续探索:

  1. 学习使用Entity Framework Core添加数据库支持
  2. 了解如何创建和使用Web API
  3. 研究用户认证和授权机制
  4. 探索部署ASP.NET Core应用到生产环境

ASP.NET Core提供了丰富的功能和灵活的架构,能够满足从简单网站到复杂企业级应用的各种需求。