ASP.NET Core 项目怎么构建

ASP.NET Core 是一个跨平台、高性能的开源框架，用于构建现代化的 Web 应用程序和 API。它结合了 ASP.NET 的成熟性和 .NET Core 的灵活性，使得开发者能够轻松构建高性能、可扩展的应用程序。本文将详细介绍如何从零开始构建一个 ASP.NET Core 项目，涵盖项目创建、目录结构、配置、路由、控制器、视图、模型、数据库集成等核心内容。

1. 环境准备

在开始构建 ASP.NET Core 项目之前，确保你的开发环境已经准备好。以下是所需的环境和工具：

• .NET SDK：ASP.NET Core 是基于 .NET Core 构建的，因此需要安装 .NET SDK。你可以从 .NET 官方网站 下载并安装最新版本的 SDK。
• IDE：你可以使用 Visual Studio、Visual Studio Code 或 JetBrains Rider 等 IDE 来开发 ASP.NET Core 项目。本文将以 Visual Studio Code 为例进行讲解。
• 命令行工具：ASP.NET Core 提供了丰富的命令行工具，可以通过命令行创建、构建和运行项目。

2. 创建 ASP.NET Core 项目

2.1 使用命令行创建项目

首先，打开命令行工具（如 PowerShell、CMD 或 Terminal），然后使用以下命令创建一个新的 ASP.NET Core 项目：

dotnet new webapp -o MyFirstAspNetCoreApp

这个命令会创建一个名为 MyFirstAspNetCoreApp 的 ASP.NET Core Web 应用程序项目。-o 参数指定了项目的输出目录。

2.2 项目结构

创建项目后，进入项目目录并查看生成的文件和文件夹结构：

cd MyFirstAspNetCoreApp

项目结构如下：

MyFirstAspNetCoreApp/
├── Pages/
│   ├── Index.cshtml
│   ├── Privacy.cshtml
│   └── _ViewStart.cshtml
├── wwwroot/
│   ├── css/
│   ├── js/
│   └── lib/
├── appsettings.json
├── Program.cs
├── Startup.cs
└── MyFirstAspNetCoreApp.csproj

• Pages/：包含 Razor 页面，用于处理用户请求并生成 HTML 响应。
• wwwroot/：静态文件目录，用于存放 CSS、JavaScript、图片等静态资源。
• appsettings.json：应用程序的配置文件，用于存储连接字符串、日志配置等。
• Program.cs：应用程序的入口点，负责配置和启动 Web 主机。
• Startup.cs：应用程序的启动类，用于配置服务和中间件。
• MyFirstAspNetCoreApp.csproj：项目文件，定义了项目的依赖项和构建配置。

2.3 运行项目

在项目目录下，使用以下命令运行项目：

dotnet run

运行后，ASP.NET Core 会启动一个本地 Web 服务器，并监听 http://localhost:5000 和 https://localhost:5001。打开浏览器并访问 http://localhost:5000，你将看到默认的欢迎页面。

3. 配置应用程序

3.1 配置文件

ASP.NET Core 使用 appsettings.json 文件来存储应用程序的配置。你可以在该文件中添加自定义配置项，例如：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=MyDatabase;User Id=myUser;Password=myPassword;"
  }
}

在代码中，你可以通过依赖注入访问这些配置项。例如，在 Startup.cs 中：

public void ConfigureServices(IServiceCollection services)
{
    var connectionString = Configuration.GetConnectionString("DefaultConnection");
    // 使用 connectionString 进行数据库连接
}

3.2 环境配置

ASP.NET Core 支持多环境配置。你可以为不同的环境（如开发、生产）创建不同的配置文件，例如 appsettings.Development.json 和 appsettings.Production.json。ASP.NET Core 会根据当前环境自动加载相应的配置文件。

4. 路由与控制器

4.1 路由配置

ASP.NET Core 使用路由系统将传入的 HTTP 请求映射到相应的控制器和操作方法。默认情况下，ASP.NET Core 使用基于约定的路由配置。你可以在 Startup.cs 中自定义路由：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        app.UseExceptionHandler("/Home/Error");
        app.UseHsts();
    }

    app.UseHttpsRedirection();
    app.UseStaticFiles();
    app.UseRouting();
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    });
}

4.2 创建控制器

控制器是处理用户请求的核心组件。你可以使用以下命令创建一个新的控制器：

dotnet add package Microsoft.VisualStudio.Web.CodeGeneration.Design
dotnet tool install -g dotnet-aspnet-codegenerator
dotnet aspnet-codegenerator controller -name HomeController -m MyModel -dc MyDbContext --relativeFolderPath Controllers

或者手动创建控制器类：

using Microsoft.AspNetCore.Mvc;

namespace MyFirstAspNetCoreApp.Controllers
{
    public class HomeController : Controller
    {
        public IActionResult Index()
        {
            return View();
        }

        public IActionResult Privacy()
        {
            return View();
        }
    }
}

4.3 创建视图

视图是用于生成 HTML 响应的 Razor 页面。你可以在 Views/Home 目录下创建与控制器方法对应的视图文件，例如 Index.cshtml 和 Privacy.cshtml。

@{
    ViewData["Title"] = "Home Page";
}

<div class="text-center">
    <h1 class="display-4">Welcome</h1>
    <p>Learn about <a href="https://docs.microsoft.com/aspnet/core">building Web apps with ASP.NET Core</a>.</p>
</div>

5. 数据库集成

5.1 使用 Entity Framework Core

Entity Framework Core (EF Core) 是 ASP.NET Core 中常用的 ORM 框架，用于与数据库进行交互。你可以使用以下命令安装 EF Core：

dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Design

5.2 创建数据库上下文

数据库上下文是 EF Core 的核心组件，用于管理实体类和数据库之间的映射。你可以创建一个继承自 DbContext 的类：

using Microsoft.EntityFrameworkCore;

namespace MyFirstAspNetCoreApp.Models
{
    public class MyDbContext : DbContext
    {
        public MyDbContext(DbContextOptions<MyDbContext> options)
            : base(options)
        {
        }

        public DbSet<MyModel> MyModels { get; set; }
    }
}

5.3 配置数据库连接

在 appsettings.json 中配置数据库连接字符串：

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=localhost;Database=MyDatabase;User Id=myUser;Password=myPassword;"
  }
}

然后在 Startup.cs 中配置数据库上下文：

public void ConfigureServices(IServiceCollection services)
{
    services.AddDbContext<MyDbContext>(options =>
        options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));
}

5.4 数据库迁移

使用 EF Core 的迁移功能来创建和更新数据库架构：

dotnet ef migrations add InitialCreate
dotnet ef database update

6. 部署应用程序

6.1 发布应用程序

使用以下命令将应用程序发布到指定目录：

dotnet publish -c Release -o ./publish

6.2 部署到服务器

将发布目录中的文件上传到服务器，并配置 Web 服务器（如 IIS、Nginx 或 Apache）以托管 ASP.NET Core 应用程序。

7. 总结

本文详细介绍了如何从零开始构建一个 ASP.NET Core 项目，涵盖了项目创建、配置、路由、控制器、视图、模型、数据库集成等核心内容。通过掌握这些基础知识，你可以轻松构建和部署高性能的 ASP.NET Core 应用程序。随着对 ASP.NET Core 的深入了解，你还可以探索更多高级功能，如身份验证、授权、缓存、日志记录等，以构建更加复杂和强大的 Web 应用程序。