Rafy 框架 - 为数据库生成注释

 

当开发者使用 CodeFirst 开发模式，编写了大量的实体类，在代码中编写了完整的类型注释和属性注释，并自动生成数据库后，往往需要把实体类型和实体属性上的注释同时生成到对应的数据库表及字段上。这样，即方便在查看数据库时能清晰地看到每一个表及字段的含义，也方便使用一些第三方的工具（如 PowerDesigner 等）为数据库生成较为全面的文档。

 

使用方法

---

1. 在为数据库生成注释之前，需要保证数据库已经全部生成成功（即和实体保持一致）。否则更新字段的注释时，可能因为字段不存在而导致执行失败。

2. 需要在编译领域实体所在的程序集时，同时生成对应的 XML 注释文件。否则，程序会找不到需要编写的注释。

   打开方法：在领域实体项目上点击右键->属性->编译->输出->在“XML document file”前打勾。

3. 打开后，重新编译整个解决方案。

4. 编写以下代码来生成数据库的注释。（只需要执行一次即可）

 

using (var context = new RafyDbMigrationContext(JXCEntityRepositoryDataProvider.DbSettingName))
{
    context.RefreshComments();
}

 

注意

目前为数据库生成注释的功能，只支持 Oracle 和 SqlServer 两个数据库。

 

PS:该文已经纳入《 Rafy 用户手册》中。