入门教程

本文档假设你更喜欢使用 Blazor WebAssembly 作为 UI 框架, 使用 MongoDB 作为数据库提供程序. 对于其他选项, 请更改本文档顶部的首选项.

创建数据库

检查在 .HttpApi.Host 项目中 appsettings.json 文件里的连接字符串.

"ConnectionStrings": {
  "Default": "mongodb://localhost:27017/BookStore"
}

该解决方案配置为在本地计算机中使用 MongoDB, 因此你需要启动并运行 MongoDB 服务器实例, 或者将连接字符串更改为另一台 MongoDB 服务器.

该解决方案带有 .DbMigrator 的控制台程序用于 初始化种子数据. 它在开发和生产环境中都很有用.

.dbMigator 项目有自己的 appsettings.json. 因此, 如果你更改了之前的连接字符串, 那么也应该更改这个连接字符串.

右键单击 .dbMigration 项目, 然后选择 设置为启动项目

按F5(或Ctrl + F5) 运行应用程序. 它将具有如下所示的输出:

初始的种子数据在数据库中创建了 admin 用户(密码为1q2w3E*) 用于登录应用程序. 所以, 对于新数据库至少使用 .DbMigrator 一次.

确保 .HttpApi.Host 项目是启动项目, 然后运行应用程序将打开 Swagger UI 的:

在 Visual Studio 中使用 Ctrl+F5(而不是F5) 在不进行调试的情况下运行应用程序. 如果你没有调试目的, 这会更快.

你可以在这里查看应用程序的API并测试它们. 获取Swagger UI的更多信息.

确保 .Blazor 项目是启动项目并运行应用程序.

在 Visual Studio 中使用 Ctrl+F5(而不是F5) 在不进行调试的情况下运行应用程序. 如果你没有调试目的, 这会更快.

应用程序启动后, 单击页头上的 Login 链接, 你将重定向到身份验证服务器以输入用户名和密码:

输入用户名 admin 和密码 1q2w3E* 登录应用程序. 应用程序已启动并正在运行. 你可以根据此启动模板开始开发应用程序.