使用指南
创建实体
您可以从零开始或从现有数据库表创建实体。
要从零开始创建实体,您可以选择 实体设计(从零开始)。
然后您可以创建一个或多个实体表。 每个实体表将被创建为一张数据库表。 字段设置将用于创建表架构。
要从现有数据库表创建实体,您可以使用 实体设计(从数据库导入) 项。
然后您可以修改实体表并创建新数据库或将更改迁移到现有数据库。
创建和设计实体时请注意以下事项:
数据库是在您生成项目并运行 Web API 项目后创建的。 默认情况下,将在 [project].WebApi 项目下创建 SQLite 数据库(数据库文件 data.db)。
数据库创建完成后,如果要对实体表进行更改(包括添加/删除/修改字段或删除实体表),可能会发生数据库冲突,数据操作可能失败。 您需要按照 实体表更改后更新数据库 中的说明手动删除或迁移数据库。
例如,要添加一个空白实体:
步骤 1:右键单击设计项目节点并选择 添加 > 新建项。 在 添加新项 对话框中,选择 实体设计(从零开始),指定实体名称,然后单击 创建。
步骤 2:在实体设计器中,从左边的组件库拖拽 空白表 组件到中间的设计视窗中。
步骤 3:在右边 实体(表) 选项卡中,单击 +添加 以添加并指定列设置。
步骤 4:您可以打开 演示应用 中的 database.sde 文件仔细查看这些设置。
从实体生成数据库
创建实体后,您可以从这些实体自动生成数据库。
步骤 1:在设计项目中创建实体后,右键单击设计项目节点并选择 生成项目。配置文件向导将打开。
默认情况下,将在 [project].WebApi 的根文件夹中创建本地 SQLite 数据库(data.db)。
您还可以在配置文件向导中创建或选择不同的数据库连接。
步骤 2:选择现有数据库连接或选择 新建 创建新的数据库连接。
步骤 3:保存配置文件,然后单击 生成项目 生成项目。
项目生成后会自动加载到解决方案中。
步骤 4:在 IDE 工具栏中,从项目列表中选择 [project].WebApi,然后单击 运行 来启动 Web API。
Web API 成功启动后,会自动生成数据库文件。
例如,默认情况下会在 [project].WebApi 的根文件夹下自动生成一个 SQLite 数据库(data.db)。 有关更多信息,请参阅 管理和更新数据库连接。
从数据库生成实体
请参阅 这个小节。
添加或修改实体字段
一旦数据库文件生成后(例如生成并运行 Web API),在现有实体中添加/删除/修改字段可能会导致数据库冲突(从而导致数据操作失败)。 在这种情况下,您需要按照 实体更改后更新数据库中的说明手动删除或迁移数据库。
如果您修改实体中的以下字段设置,则需要手动删除或迁移数据库,以便将这些更改包含在数据库架构中。
- 列名
- 数据类型
- 集合
- 可空
- 主键
- 索引
- 索引 > 唯一
创建外键约束
请参阅 这个小节。
创建枚举
请参阅 这个小节。
创建模型
请参阅 这个小节。
生成序列或流水号
请参阅 这个小节。
添加自定义代码
请参阅 这个小节。
添加外部数据源
请参阅 这个小节。
添加静态数据源
请参阅 这个小节。
认证和授权
请参阅 这个小节。
创建逻辑
请参阅 这个小节。
设计过滤器
请参阅 这个小节。
设计方法
请参阅 这个小节。
创建视图
请参阅 这个小节。
配置事件
请参阅 这个小节。
生成项目
请参阅 这个小节。
修改生成的项目
不建议直接修改生成的项目,因为这些项目在每次执行生成项目时都会自动生成。 如果您直接对自动生成的文件进行更改,则下次再次生成项目时,更改将被覆盖。
如果您想将自己的脚本添加到生成的项目中,可以考虑以下选项:
- 添加自定义代码。
- 创建一个新项目并将脚本放入新项目中,并在该新项目和自动生成的项目之间进行引用。
- 在生成的项目中创建一个新的类文件,并将脚本放入新的类文件中。