Translate ef core dbms provider integration document

docs/zh-Hans/Entity-Framework-Core-MySQL.md

@@ -23,11 +23,11 @@
 
 MySQL连接字符串与SQL Server连接字符串不同. 所以检查你的解决方案中所有的 `appsettings.json` 文件,更改其中的连接字符串. 有关MySQL连接字符串选项的详细内容请参见[connectionstrings.com](https://www.connectionstrings.com/mysql/).
 
-You typically will change the `appsettings.json` inside the `.DbMigrator` and `.Web` projects, but it depends on your solution structure.
+通常需要更改 `.DbMigrator` 和 `.Web` 项目里面的 `appsettings.json` ,但它取决于你的解决方案结构.
 
 ## 更改迁移DbContext
 
-MySQL DBMS与SQL Server有一些细微的差异. 某些模块数据库映射配置(尤其是字段长度)会导致MySQL出现问题. 例如某些IdentityServer模块表就存在这样的问题,它提供了一个选项可以根据您的DBMS配置字段.
+MySQL DBMS与SQL Server有一些细微的差异. 某些模块数据库映射配置(尤其是字段长度)会导致MySQL出现问题. 例如某些[IdentityServer模块](Modules/IdentityServer.md)表就存在这样的问题,它提供了一个选项可以根据您的DBMS配置字段.
 
 启动模板包含*YourProjectName*MigrationsDbContext,它负责维护和迁移数据库架构. 此DbContext基本上调用依赖模块的扩展方法来配置其数据库表.
 

docs/zh-Hans/Entity-Framework-Core-Other-DBMS.md

@@ -0,0 +1,90 @@
+# 切换到EF Core 其它DBMS提供程序
+
+**[应用程序启动模板](Startup-Templates/Application.md)** 为EF Core预配置了Sql Server提供程序,EF Core支持许多其它DBMS,你可以在基于ABP的应用程序使用它们.
+
+ABP框架为一些常见的DMBS提供了简化配置的集成包(有关可用集成包的列表,请参阅[EF Core文档](Entity-Framework-Core.md)),你也可以不使用集成包配置DBMS提供程序.
+
+虽然总是建议使用集成包(它也使不同模块之间的依赖版本成为标准版本),但是如果没有用于DBMS提供程序的集成包,也可以手动集成.
+
+本文介绍了如何在不使用[MySQL集成包](Entity-Framework-Core-MySQL.md)的情况下切换到MySQL.
+
+## 替换SQL Server依赖
+
+* 删除 `.EntityFrameworkCore` 项目依赖的 [Volo.Abp.EntityFrameworkCore.SqlServer](https://www.nuget.org/packages/Volo.Abp.EntityFrameworkCore.SqlServer) NuGet 包.
+* 添加 [Pomelo.EntityFrameworkCore.MySql](https://www.nuget.org/packages/Pomelo.EntityFrameworkCore.MySql/) NuGet 包到 `.EntityFrameworkCore` 项目.
+
+## 删除模块依赖项
+
+从 ***YourProjectName*EntityFrameworkCoreModule** 类的依赖列表中删除`AbpEntityFrameworkCoreSqlServerModule`.
+
+## 更改UseSqlServer()调用
+
+在*YourProjectName*EntityFrameworkCoreModule类中找到以下代码:
+
+````csharp
+Configure<AbpDbContextOptions>(options =>
+{
+    options.UseSqlServer();
+});
+````
+
+替换成以下代码:
+
+````csharp
+Configure<AbpDbContextOptions>(options =>
+{
+    options.Configure(ctx =>
+    {
+        if (ctx.ExistingConnection != null)
+        {
+            ctx.DbContextOptions.UseMySql(ctx.ExistingConnection);
+        }
+        else
+        {
+            ctx.DbContextOptions.UseMySql(ctx.ConnectionString);
+        }
+    });
+});
+````
+
+* 调用的 `UseMySql` 代码是在 Pomelo.EntityFrameworkCore.MySql 包中定义的,方法还有附加选项,如果需要可以使用它.
+* 这段代码首先检查当前请求中是否存在到相同数据库的现有(活动)连接,并在可能的情况下重用它. 这允许在不同的DbContext类型之间共享单个事务. ABP处理其余的事情.
+* 如果没有活动的连接,它将把 `ctx.ConnectionString` 传递给UseMySql(这将创建新的数据库连接). 这里使用 `ctx.ConnectionString` 很重要. 不要传递静态连接字符串(或配置中的连接字符串). 因为ABP在多数据库或[多租户](Multi-Tenancy.md)环境中[动态确定正确的连接字符串](Connection-Strings.md).
+
+## 更改连接连接字符串
+
+MySQL连接字符串与SQL Server连接字符串不同. 所以检查你的解决方案中所有的 `appsettings.json` 文件,更改其中的连接字符串. 有关MySQL连接字符串选项的详细内容请参见[connectionstrings.com](https://www.connectionstrings.com/mysql/).
+
+通常需要更改 `.DbMigrator` 和 `.Web` 项目里面的 `appsettings.json` ,但它取决于你的解决方案结构.
+
+## 更改迁移DbContext
+
+MySQL DBMS与SQL Server有一些细微的差异. 某些模块数据库映射配置(尤其是字段长度)会导致MySQL出现问题. 例如某些[IdentityServer模块](Modules/IdentityServer.md)表就存在这样的问题,它提供了一个选项可以根据您的DBMS配置字段.
+
+启动模板包含*YourProjectName*MigrationsDbContext,它负责维护和迁移数据库架构. 此DbContext基本上调用依赖模块的扩展方法来配置其数据库表.
+
+打开 *YourProjectName*MigrationsDbContext 更改 `builder.ConfigureIdentityServer();` 行,如下所示:
+
+````csharp
+builder.ConfigureIdentityServer(options =>
+{
+    options.DatabaseProvider = EfCoreDatabaseProvider.MySql;
+});
+````
+
+然后 `ConfigureIdentityServer()` 方法会将字段长度设置为超过MySQL的限制. 如果在创建或执行数据库迁移时遇到任何问题请参考相关的模块文档.
+
+## 重新生成迁移
+
+启动模板使用[Entity Framework Core的Code First迁移](https://docs.microsoft.com/zh-cn/ef/core/managing-schemas/migrations/). EF Core迁移取决于所选的DBMS提供程序. 因此更改DBMS提供程序会导致迁移失败.
+
+* 删除 `.EntityFrameworkCore.DbMigrations` 项目下的Migrations文件夹,并重新生成解决方案.
+* 在包管理控制台中运行 `Add-Migration "Initial"`(在解决方案资源管理器选择 `.DbMigrator`  (或 `.Web`) 做为启动项目并且选择 `.EntityFrameworkCore.DbMigrations` 做为默认项目).
+
+这将创建一个配置所有数据库对象(表)的数据库迁移.
+
+运行 `.DbMigrator` 项目创建数据库和初始种子数据.
+
+## 运行应用程序
+
+它已准备就绪, 只需要运行该应用程序与享受编码.

docs/zh-Hans/Entity-Framework-Core-PostgreSQL.md

@@ -1,35 +1,41 @@
-## Entity Framework Core PostgreSQL 集成
+# 切换到EF Core PostgreSQL提供程序
 
-> 参阅 [Entity Framework Core 集成文档](../Entity-Framework-Core.md) 了解集成EF Core的基础知识.
+本文介绍如何将预配置为SqlServer提供程序的 **[应用程序启动模板](Startup-Templates/Application.md)** 切换到 **PostgreSQL** 数据库提供程序
 
-### 更新 EntityFrameworkCore 项目
+## 替换Volo.Abp.EntityFrameworkCore.SqlServer包
 
-- 在 `Acme.BookStore.EntityFrameworkCore` 中将包 `Volo.Abp.EntityFrameworkCore.SqlServer` 替换为 `Volo.Abp.EntityFrameworkCore.PostgreSql` 
-- 打开 `BookStoreEntityFrameworkCoreModule` 模块类
-  - 将 `AbpEntityFrameworkCoreSqlServerModule` 替换为 `AbpEntityFrameworkCorePostgreSqlModule`
-  - 将 `options.UseSqlServer()` 替换为 `options.UsePostgreSql()`
-- 在其他的项目中将 `appsetting.json` 文件中的连接字符串更新为PostgreSQL链接字符串
+解决方案中的 `.EntityFrameworkCore` 项目依赖于 [Volo.Abp.EntityFrameworkCore.SqlServer](https://www.nuget.org/packages/Volo.Abp.EntityFrameworkCore.SqlServer) NuGet包. 删除这个包并且添加相同版本的 [Volo.Abp.EntityFrameworkCore.PostgreSql](https://www.nuget.org/packages/Volo.Abp.EntityFrameworkCore.PostgreSql) 包.
 
-#### 删除现有迁移
+## 替换模块依赖项
 
-删除所有的现有迁移文件 (包括 `DbContextModelSnapshot`)
+在 `.EntityFrameworkCore` 项目中找到 **YourProjectName*EntityFrameworkCoreModule** 类, 删除 `DependsOn` attribute 上的`typeof(AbpEntityFrameworkCoreSqlServerModule)`, 添加 `typeof(AbpEntityFrameworkCorePostgreSqlModule)` (或者替换 `using Volo.Abp.EntityFrameworkCore.SqlServer;` 为 `using Volo.Abp.EntityFrameworkCore.PostgreSql;`).
 
-![postgresql-delete-initial-migrations](images/postgresql-delete-initial-migrations.png)
+## UsePostgreSql()
 
-#### 生成生成迁移并更新数据库
+查找你的解决方案中 `UseSqlServer()`调用，替换为 `UsePostgreSql()`. 检查下列文件:
 
-设置正确的启动项目 (通常是Web项目),
-打开 **程序包管理器控制台** (工具 -> Nuget包管理器 -> 程序包管理器控制台), 选择 `Acme.BookStore.EntityFrameworkCore.DbMigrations` 做为 **默认项目** 并执行以下命令:
+* `.EntityFrameworkCore` 项目中的*YourProjectName*EntityFrameworkCoreModule.cs.
+* `.EntityFrameworkCore` 项目中的*YourProjectName*MigrationsDbContextFactory.cs.
 
-运行 `Add-Migration` 命令.
-````
-PM> Add-Migration Initial
-````
+> 根据你的解决方案的结构，你可能发现更多需要改变代码的文件.
 
-然后执行 `Update-Database` 执行更新数据库:
+## 更改连接字符串
 
-````
-PM> Update-Database
-````
+PostgreSql连接字符串与SQL Server连接字符串不同. 所以检查你的解决方案中所有的 `appsettings.json` 文件,更改其中的连接字符串. 有关PostgreSql连接字符串选项的详细内容请参见[connectionstrings.com](https://www.connectionstrings.com/postgresql/).
 
-![postgresql-update-database](images/postgresql-update-database.png)
+通常需要更改 `.DbMigrator` 和 `.Web` 项目里面的 `appsettings.json` ,但它取决于你的解决方案结构.
+
+## 重新生成迁移
+
+启动模板使用[Entity Framework Core的Code First迁移](https://docs.microsoft.com/zh-cn/ef/core/managing-schemas/migrations/). EF Core迁移取决于所选的DBMS提供程序. 因此更改DBMS提供程序会导致迁移失败.
+
+* 删除 `.EntityFrameworkCore.DbMigrations` 项目下的Migrations文件夹,并重新生成解决方案.
+* 在包管理控制台中运行 `Add-Migration "Initial"`(在解决方案资源管理器选择 `.DbMigrator`  (或 `.Web`) 做为启动项目并且选择 `.EntityFrameworkCore.DbMigrations` 做为默认项目).
+
+这将创建一个配置所有数据库对象(表)的数据库迁移.
+
+运行 `.DbMigrator` 项目创建数据库和初始种子数据.
+
+## 运行应用程序
+
+它已准备就绪, 只需要运行该应用程序与享受编码.

docs/zh-Hans/Entity-Framework-Core-SQLite.md

@@ -0,0 +1,41 @@
+# 切换到EF Core SQLite提供程序
+
+本文介绍如何将预配置为SqlServer提供程序的 **[应用程序启动模板](Startup-Templates/Application.md)** 切换到 **SQLite** 数据库提供程序.
+
+## 替换Volo.Abp.EntityFrameworkCore.SqlServer包
+
+解决方案中的 `.EntityFrameworkCore` 项目依赖于 [Volo.Abp.EntityFrameworkCore.SqlServer](https://www.nuget.org/packages/Volo.Abp.EntityFrameworkCore.SqlServer) NuGet包. 删除这个包并且添加相同版本的 [Volo.Abp.EntityFrameworkCore.SQLite](https://www.nuget.org/packages/Volo.Abp.EntityFrameworkCore.SQLite) 包.
+
+## 替换模块依赖项
+
+在 `.EntityFrameworkCore` 项目中找到 **YourProjectName*EntityFrameworkCoreModule** 类, 删除 `DependsOn` attribute 上的`typeof(AbpEntityFrameworkCoreSqlServerModule)`, 添加 `typeof(AbpEntityFrameworkCoreSqliteModule)` (或者替换 `using Volo.Abp.EntityFrameworkCore.SqlServer;` 为 `using Volo.Abp.EntityFrameworkCore.Sqlite;`).
+
+## UseSqlite()
+
+查找你的解决方案中 `UseSqlServer()`调用，替换为 `UseSqlite()`. 检查下列文件:
+
+* `.EntityFrameworkCore` 项目中的*YourProjectName*EntityFrameworkCoreModule.cs.
+* `.EntityFrameworkCore` 项目中的*YourProjectName*MigrationsDbContextFactory.cs.
+
+> 根据你的解决方案的结构，你可能发现更多需要改变代码的文件.
+
+## 更改连接字符串
+
+SQLite连接字符串与SQL Server连接字符串不同. 所以检查你的解决方案中所有的 `appsettings.json` 文件,更改其中的连接字符串. 有关SQLite连接字符串选项的详细内容请参见[connectionstrings.com](https://www.connectionstrings.com/sqlite/).
+
+通常需要更改 `.DbMigrator` 和 `.Web` 项目里面的 `appsettings.json` ,但它取决于你的解决方案结构.
+
+## 重新生成迁移
+
+启动模板使用[Entity Framework Core的Code First迁移](https://docs.microsoft.com/zh-cn/ef/core/managing-schemas/migrations/). EF Core迁移取决于所选的DBMS提供程序. 因此更改DBMS提供程序会导致迁移失败.
+
+* 删除 `.EntityFrameworkCore.DbMigrations` 项目下的Migrations文件夹,并重新生成解决方案.
+* 在包管理控制台中运行 `Add-Migration "Initial"`(在解决方案资源管理器选择 `.DbMigrator`  (或 `.Web`) 做为启动项目并且选择 `.EntityFrameworkCore.DbMigrations` 做为默认项目).
+
+这将创建一个配置所有数据库对象(表)的数据库迁移.
+
+运行 `.DbMigrator` 项目创建数据库和初始种子数据.
+
+## 运行应用程序
+
+它已准备就绪, 只需要运行该应用程序与享受编码.

docs/zh-Hans/Entity-Framework-Core.md

@@ -1,8 +1,8 @@
-## Entity Framework Core 集成
+# Entity Framework Core 集成
 
 本文介绍了如何将EF Core作为ORM提供程序集成到基于ABP的应用程序以及如何对其进行配置.
 
-### 安装
+## 安装
 
 `Volo.Abp.EntityFrameworkCore` 是EF Core 集成的主要nuget包. 将其安装到你的项目中(在分层应用程序中适用于 数据访问/基础设施层):
 
@@ -26,7 +26,22 @@ namespace MyCompany.MyProject
 }
 ````
 
-### 创建 DbContext
+> 注: 你可以直接下载预装EF Core的[启动模板](https://abp.io/Templates).
+
+### 数据库管理系统选择
+
+EF Core支持多种数据库管理系统([查看全部](https://docs.microsoft.com/en-us/ef/core/providers/)). ABP框架和本文档不依赖于任何特定的DBMS.
+
+如果要创建一个可重用的库,应避免依赖于特定的DBMS包.但在最终的应用程序中,始终会选择一个DBMS.
+
+ABP框架为一些常见的DBMS提供了集成包,使配置变得更加简单. [启动模板](Startup-Templates/Index.md)附带**预先配置的SQL Server (localdb)**.请参阅以下文档,了解如何配置其他DBMS提供程序:
+
+* [MySQL](Entity-Framework-Core-MySQL.md)
+* [PostgreSQL](Entity-Framework-Core-PostgreSQL.md)
+* [SQLite](Entity-Framework-Core-SQLite.md)
+* [Others](Entity-Framework-Core-Other-DBMS.md)
+
+## 创建 DbContext
 
 你可以平常一样创建DbContext,它需要继承自 `AbpDbContext<T>`. 如下所示:
 
@@ -48,7 +63,22 @@ namespace MyCompany.MyProject
 }
 ````
 
-### 将DbContext注册到依赖注入
+### 配置连接字符串选择
+
+如果你的应用程序有多个数据库,你可以使用 `connectionStringName]` Attribute为你的DbContext配置连接字符串名称.
+例：
+
+```csharp
+[ConnectionStringName("MySecondConnString")]
+public class MyDbContext : AbpDbContext<MyDbContext>
+{
+
+}
+```
+
+如果不进行配置,则使用`Default`连接字符串. 如果你配置特定的连接字符串的名称,但在应用程序配置中没有定义这个连接字符串名称,那么它会回退到`Default`连接字符串(参阅[连接字符串文档](Connection-Strings.md)了解更多信息).
+
+## 将DbContext注册到依赖注入
 
 在module中的ConfigureServices方法使用 `AddAbpDbContext` 在[依赖注入](Dependency-Injection.md)系统注册DbContext类.
 
@@ -72,7 +102,7 @@ namespace MyCompany.MyProject
 }
 ````
 
-#### 添加默认仓储
+### 添加默认仓储
 
 ABP会自动为DbContext中的实体创建[默认仓储](Repositories.md). 需要在注册的时使用options添加`AddDefaultRepositories()`:
 
@@ -174,7 +204,7 @@ public class BookRepository : EfCoreRepository<BookStoreDbContext, Book, Guid>,
 
 现在可以在需要时[注入](Dependency-Injection.md)`IBookRepository`并使用`DeleteBooksByType`方法.
 
-##### 覆盖默认通用仓储
+#### 覆盖默认通用仓储
 
 即使创建了自定义仓储,仍可以注入使用默认通用仓储(在本例中是 `IRepository<Book, Guid>`). 默认仓储实现不会使用你创建的自定义仓储类.
 
@@ -200,7 +230,7 @@ public override async Task DeleteAsync(
 }
 ````
 
-#### 访问 EF Core API
+### 访问 EF Core API
 
 大多数情况下应该隐藏仓储后面的EF Core API(这也是仓储的设计目地). 但是如果想要通过仓储访问DbContext实现,则可以使用`GetDbContext()`或`GetDbSet()`扩展方法. 例：
 
@@ -226,9 +256,9 @@ public class BookService
 
 > 要点: 你必须在使用`DbContext`的项目里引用`Volo.Abp.EntityFrameworkCore`包. 这会破坏封装,但在这种情况下,这就是你需要的.
 
-#### 高级主题
+### 高级主题
 
-##### 设置默认仓储类
+#### 设置默认仓储类
 
 默认的通用仓储的默认实现是`EfCoreRepository`类,你可以创建自己的实现,并将其做为默认实现
 
@@ -273,7 +303,7 @@ context.Services.AddAbpDbContext<BookStoreDbContext>(options =>
 });
 ```
 
-#### 为默认仓储设置Base DbContext类或接口
+### 为默认仓储设置Base DbContext类或接口
 
 如果你的DbContext继承了另外一个DbContext或实现了一个接口,你可以使用这个基类或接口作为默认仓储的DbContext. 例:
 
@@ -305,7 +335,7 @@ public class BookRepository : EfCoreRepository<IBookStoreDbContext, Book, Guid>,
 
 使用DbContext接口的一个优点是它可以被其他实现替换.
 
-#### 替换其他仓储
+### 替换其他仓储
 
 正确定义并使用DbContext接口后,任何其他实现都可以使用以下ReplaceDbContext options 替换它:
 

docs/zh-Hans/docs-nav.json

@@ -272,13 +272,16 @@
                   "path": "Entity-Framework-Core-MySQL.md"
                 },
                 {
-                  "text": "切换到PostgreSQL"
+                  "text": "切换到PostgreSQL",
+                  "path": "Entity-Framework-Core-PostgreSQL.md"
                 },
                 {
-                  "text": "切换到SQLite"
+                  "text": "切换到SQLite",
+                  "path": "Entity-Framework-Core-SQLite.md"
                 },
                 {
-                  "text": "切换到其他DBMS"
+                  "text": "切换到其他DBMS",
+                  "path": "Entity-Framework-Core-Other-DBMS.md"
                 }
               ]
             },