ASP.NET Core 用于 C# (.NET)：完整指南与示例

什么是 ASP.NET Core，为什么需要它？

ASP.NET Core 是微软推出的一个现代、跨平台、高性能的开源 Web 框架，用于使用 C# (.NET) 语言构建 Web 应用程序、API、微服务和云解决方案。与仅在 Windows 上运行的经典 ASP.NET (Framework) 不同，ASP.NET Core 完全跨平台：它可以在 Windows、Linux 和 macOS 上运行。

为什么需要它？ASP.NET Core 为开发人员提供了构建现代 Web 应用程序的强大工具集。它包括对依赖注入 (Dependency Injection)、中间件 (middleware)、路由、身份验证、通过 Entity Framework Core 进行数据库操作等的内置支持。该框架针对高性能和可扩展性进行了优化，使其成为构建小型网站和大型企业系统的理想选择。

ASP.NET Core 的主要优势：

• 跨平台：可在 Windows、Linux 和 macOS 上运行。
• 高性能：最快的 Web 框架之一。
• 模块化：您只连接应用程序所需的组件。
• 内置依赖注入支持：简化代码测试和维护。
• 开源：源代码可在 GitHub 上获取，社区积极开发该框架。
• 统一的编程模型：可以创建 MVC 应用程序、Web API、Razor Pages、Blazor 和 SignalR。

安装 ASP.NET Core

要开始使用 ASP.NET Core，您需要安装 .NET SDK (软件开发工具包)。这不是通过 pip 或 npm 安装的包，而是一个完整的开发环境。

安装步骤：

1. 下载 .NET SDK：访问官方网站 dotnet.microsoft.com/download 并下载适用于您操作系统（Windows、Linux、macOS）的最新 .NET SDK 版本。
2. 安装 SDK：运行安装程序并按照说明操作。安装后，重新启动计算机（或终端）。
3. 验证安装：打开终端（命令行）并执行命令：

   dotnet --version

   如果您看到版本号（例如 8.0.100），则安装成功。

安装 SDK 后，您将可以使用 dotnet 命令，该命令用于创建、构建和运行项目。

快速入门及代码示例

让我们创建一个简单的 ASP.NET Core Web 应用程序 (Web API)，它将返回 "Hello, World!"。

步骤 1：创建项目

打开终端并执行命令：

dotnet new webapi -n MyFirstApicd MyFirstApi

此命令将创建一个名为 MyFirstApi 的新 Web API 项目，并进入其文件夹。

步骤 2：项目结构

在项目文件夹中，您会看到几个文件。主要文件包括：

• Program.cs — 应用程序的入口点，在此配置请求处理管道。
• MyFirstApi.csproj — 项目文件，包含依赖项和构建配置。
• Controllers/ — 控制器文件夹（默认情况下，其中已有 WeatherForecastController.cs）。

步骤 3：运行应用程序

在终端中执行命令：

dotnet run

运行后，您将看到一条消息，表明应用程序正在 http://localhost:5xxx 上运行（端口可能不同）。打开浏览器并访问 http://localhost:5xxx/weatherf