"StoreDbConnection": "Server=(localdb)\\<your-instance-name>; Database=StoreCF8;Trusted_Connection=True;MultipleActiveResultSets=true;"

<container> <register type="SM.Store.Api.DAL.IStoreDataUnitOfWork" mapTo="SM.Store.Api.DAL.StoreDataUnitOfWork"> <lifetime type="singleton" /> </register> <register type="SM.Store.Api.DAL.IGenericRepository[Category]" mapTo="SM.Store.Api.DAL.GenericRepository[Category]"/> <register type="SM.Store.Api.DAL.IGenericRepository[ProductStatusType]" mapTo="SM.Store.Api.DAL.GenericRepository[ProductStatusType]"/> <register type="SM.Store.Api.DAL.IProductRepository" mapTo="SM.Store.Api.DAL.ProductRepository"/> <register type="SM.Store.Api.DAL.IContactRepository" mapTo="SM.Store.Api.DAL.ContactRepository"/>    <register type="SM.Store.Api.BLL.IProductBS" mapTo="SM.Store.Api.BLL.ProductBS"/> <register type="SM.Store.Api.BLL.IContactBS" mapTo="SM.Store.Api.BLL.ContactBS"/> <register type="SM.Store.Api.BLL.ILookupBS" mapTo="SM.Store.Api.BLL.LookupBS"/>
</container>

新SM.Store.CoreApi的Startup.ConfigureServices()方法中的DI实例和类型注册：

services.AddScoped(typeof(IGenericRepository<>), typeof(GenericRepository<>));
services.AddScoped(typeof(IStoreLookupRepository<>), typeof(StoreLookupRepository<>));
services.AddScoped<IProductRepository, ProductRepository>();
services.AddScoped<IContactRepository, ContactRepository>();
services.AddScoped<ILookupBS, LookupBS>();
services.AddScoped<IProductBS, ProductBS>();
services.AddScoped<IContactBS, ContactBS>();

请注意，在旧版SM.Store.WebApi中，只有IStoreDataUnitOfWork类型注册才具有“singleton”生存期管理器。所有其他类型都使用默认值，即注册的瞬态(Transient)生存期。该StoreDataUnitOfWork对象已过时，并且不被新SM.Store.CoreApi（在后面的部分中讨论）对象使用。现在，所有数据操作对象在迁移后都设置为“Scoped生存期”，这将对象实例持久保存在同一请求上下文中。

IProductBS bs = DIFactoryDesigntime.GetInstance<IProductBS>();

在新版SM.Store.CoreApi中，通过将对象实例注入到控制器的构造函数中来执行类似的功能：

private IProductBS bs;
public ProductsController(IProductBS productBS)
{ bs = productBS;
}

许多第三方工具提供了我们也可以直接从ASP.NET Core访问的static方法。但是对于那些需要一个或多个抽象层的对象，通过DI访问抽象层实例是理想的方法。示例应用程序中使用的AutoMapper工具就是一个示例。为了使AutoMapper与ASP.NET Core DI容器一起正常工作，下面给出了以下步骤：

public interface IAutoMapConverter<TSourceObj, TDestinationObj> where TSourceObj : class where TDestinationObj : class
{ TDestinationObj ConvertObject(TSourceObj srcObj); List<TDestinationObj> ConvertObjectCollection(IEnumerable<TSourceObj> srcObj);
}

public class AutoMapConverter<TSourceObj, TDestinationObj> : IAutoMapConverter<TSourceObj, TDestinationObj> where TSourceObj : class where TDestinationObj : class
{ private AutoMapper.IMapper mapper; public AutoMapConverter() { var config = new AutoMapper.MapperConfiguration(cfg => { cfg.CreateMap<TSourceObj, TDestinationObj>(); }); mapper = config.CreateMapper(); }public TDestinationObj ConvertObject(TSourceObj srcObj) { return mapper.Map<TSourceObj, TDestinationObj>(srcObj); }public List<TDestinationObj> ConvertObjectCollection(IEnumerable<TSourceObj> srcObjList) { if (srcObjList == null) return null; var destList = srcObjList.Select(item => this.ConvertObject(item)); return destList.ToList(); }
}

services.AddScoped(typeof(IAutoMapConverter<,>), typeof(AutoMapConverter<,>));

5、将AutoMapConverter实例注入调用者类的构造函数中：

private IAutoMapConverter<Entities.Contact, Models.Contact> mapEntityToModel;
public ContactsController(IAutoMapConverter<Entities.Contact, Models.Contact> convertEntityToModel)
{ this.mapEntityToModel = convertEntityToModel;
}

6、在启动的对象实例中调用一个方法（有关详细信息，请参见ContactController.cs）：

var convtList = mapEntityToModel.ConvertObjectCollection(rtnList);

内置依赖注入的模式和实践在.NET Core 2.x和3.0版中基本相同。较新的.NET Core版本无需更改代码。

//Set database.
if (Configuration["AppConfig:UseInMemoryDatabase"] == "true")
{ services.AddDbContext<StoreDataContext>(opt => opt.UseInMemoryDatabase("StoreDbMemory"));
}
else
{ services.AddDbContext<StoreDataContext>(c => c.UseSqlServer(Configuration.GetConnectionString("StoreDbConnection")));
}

2、将强类型的定制POCO类对象链接到Option服务：

public class AppConfig
{ public string TestConfig1 { get; set; } public bool UseInMemoryDatabase { get; set; }
}

Startup.ConfigurationServices()中的代码：

//Add Support for strongly typed Configuration and map to class
services.AddOptions();
services.Configure<AppConfig>(Configuration.GetSection("AppConfig"));

然后通过将Option服务实例注入到调用者类的构造函数中来访问配置项。

//Read key and get value from AppConfig section of AppSettings.json.
public static string GetConfig(string keyName)
{ var rtnValue = string.Empty; var builder = new ConfigurationBuilder() .SetBasePath(Directory.GetCurrentDirectory()) .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true) .AddEnvironmentVariables();IConfigurationRoot configuration = builder.Build(); var value = configuration["AppConfig:" + keyName]; if (!string.IsNullOrEmpty(value)) { rtnValue = value; } return rtnValue;
}

可以在应用程序中的任何位置调用此方法。调用此方法的一个例子是从SM.Store.Api.DAL项目中的静态类StoreDataInitializer的代码。

public static class StoreDataInitializer
{ public static void Initialize(StoreDataContext context) { if (StaticConfigs.GetConfig("UseInMemoryDatabase") != "true") { context.Database.EnsureCreated(); } - - - } - - -
}

如果您愿意，ASP.NET Core应用程序仍然可以将web.config文件用于appSettings XML部分中的任何旧项。但是，该ConfigurationManager.AppSettings集合不适用于作为控制台应用程序的ASP.NET Core中的web.config。要解决此问题，StaticConfigs.cs还包含方法GetAppSetting()，用于从Core项目根目录中的web.config文件获取AppSetting值：

//Read key and get value from AppSettings section of web.config.
public static string GetAppSetting(string keyName)
{ var rtnString = string.Empty; var configPath = Path.Combine(Directory.GetCurrentDirectory(), "Web.config");            XmlDocument x = new XmlDocument(); x.Load(configPath); XmlNodeList nodeList = x.SelectNodes("//appSettings/add"); foreach (XmlNode node in nodeList) { if (node.Attributes["key"].Value == keyName) { rtnString = node.Attributes["value"].Value; break; } } return rtnString;
}

通过传递键名来获取配置值也是单行调用。

var testValue = StaticConfigs.GetAppSetting("TestWebConfig");

实体框架核心相关更改

public class ProductStatusType
{ [Key]    public int StatusCode { get; set; } public string Description { get; set; } public System.DateTime? AuditTime { get; set; }public virtual ICollection<Product> Products { get; set; }
}

数据种子数组包括StatusCode列和值：

var statusTypes = new ProductStatusType[]
{ new ProductStatusType { StatusCode = 1, Description = "Available", AuditTime = Convert.ToDateTime("2017-08-26")}, new ProductStatusType { StatusCode = 2, Description = "Out of Stock", AuditTime = Convert.ToDateTime("2017-09-26")}, - - -
};

使用EF Core，DatabaseGeneratedOption.None需要将需求显式添加到主键属性中，以避免因显式提供键和值而导致失败。上面的模型应该这样更新：

public class ProductStatusType
{ [Key] [DatabaseGenerated(DatabaseGeneratedOption.None)] public int StatusCode { get; set; } public string Description { get; set; } - - -
}

数据上下文和连接字符串

public class StoreDataContext : DbContext
{    public StoreDataContext(string connectionString) : base(connectionString) {                } - - -
}

EF Core将DbContextOption对象传递给数据上下文类。这将是类上的一个小变化。

public class StoreDataContext : DbContext
{
public StoreDataContext(DbContextOptions<StoreDataContext> options) : base(options) { } - - -
}

将数据上下文添加到Startup.ConfigurationServices()中的DI容器时，需要指定DbContextOption项目。借助此EF Core功能，我们可以使用不同的数据提供程序和与数据库操作相关的设置。在此示例应用程序中，可以使用配置设置来启用内存数据库或SQL Server数据库。

//Set database.
if (Configuration["AppConfig:UseInMemoryDatabase"] == "true")
{ services.AddDbContext<StoreDataContext>(opt => opt.UseInMemoryDatabase("StoreDbMemory"));
}
else
{ services.AddDbContext<StoreDataContext>(c => c.UseSqlServer(Configuration.GetConnectionString("StoreDbConnection")));
}

SM.Store.CoreApi的SQL Server连接字符串的值在appsettings.json文件的标准ConnectionStrings部分中进行配置。数据库文件将保存到LocalDB的Windows登录用户文件夹中，并保存到任何常规版本（包括SQL Server Express）的SQL Server定义的数据文件夹中。不能像EF6一样在连接字符串中设置LocalDB数据库文件位置的选项。如果需要为LocalDB指定其他文件位置，则可以使用SQL Server Management Studio（SSMS，免费版本17.x或最新版本）打开LocalDB实例，然后在第一次运行示例应用程序之前或在删除现有数据库之后使用脚本创建数据库。

USE MASTER
GO
CREATE DATABASE [StoreCF8]
ON (NAME = 'StoreCF8.mdf', FILENAME = <your path>\StoreCF8.mdf')
LOG ON (NAME = 'StoreCF8_log.ldf', FILENAME = <your path>\StoreCF8_log.ldf');
GO

自定义存储库(Repositories)

private StoreDataContext context;
public class StoreDataUnitOfWork : IStoreDataUnitOfWork
{ public StoreDataUnitOfWork(string connectionString) { - - - this.context = new StoreDataContext(connectionString); }     - - - public void Commit() {            this.Context.SaveChanges();         } - - -
}

然后将该UnitOfWork实例注入到任何单独的存储库和基本GenericRepository库中：

public class ProductRepository : GenericRepository<Entities.Product>, IProductRepository
{ public ProductRepository(IStoreDataUnitOfWork unitOfWork) : base(unitOfWork) { } - - -
}

尽管仍然需要自定义存储库并迁移自定义存储库，但是工作单元实践对于应用程序（甚至使用EF6）似乎是多余的。数据上下文类本身充当工作单元，在该工作单元中，SaveChanges()方法立即更新当前上下文中的挂起的更改。此外，对于具有多个数据上下文类的应用程序，我们可以使用在上下文的事务相关的方法的Database对象，如UseTransaction，BeginTransaction和CommitTransaction，实现了ACID结果。

public class ProductRepository : GenericRepository<Entities.Product>, IProductRepository
{ private StoreDataContext storeDBContext; public ProductRepository(StoreDataContext context) : base(context) { storeDBContext = context; } - - -
}

在GenericRepository类中，该CommitAllChanges()方法被新Commit()方法替换：

public virtual void CommitAllChanges()
{ this.UnitOfWork.Commit();
}

新GenericRepository类中的方法：

public virtual void Commit()
{ Context.SaveChanges();
}

此外，GenericRepository类中的任何基于Insert，Update或Delete方法都具有可选的第二个参数，如果您不想直到最后才调用Commit()方法，则可立即调用SaveChanges()方法。例如，这是Insert方法：

public virtual object Insert(TEntity entity, bool saveChanges = false)
{ var rtn = this.DbSet.Add(entity); if (saveChanges) { Context.SaveChanges(); } return rtn;
}

public class GenericRepository<TEntity> : IGenericRepository<TEntity> where TEntity : class
{ public IStoreDataUnitOfWork UnitOfWork { get; set; } public GenericRepository(IStoreDataUnitOfWork unitOfWork) { this.UnitOfWork = unitOfWork; } - - -
}

因此，如果存在多个数据上下文对象，则需要创建具有不同名称的其他泛型存储库类。在.NET Core DAL的GenericRepository类中，现在将基本DbContext注入到其构造函数中，允许其他数据上下文对象的任何继承存储库使用它。

public class GenericRepository<TEntity> : IGenericRepository<TEntity> where TEntity : class
{            private DbContext Context { get; set; } public GenericRepository(DbContext context) { Context = context; } - - -
}

进行了这样的更改后，除了直接使用GenericRepository实例来获取简单查找数据集之外，所有关联的工作流程都运行良好。SM.Store.Api.Bll/LookupBS.cs文件中的旧版Web API代码如下所示：

//Instantiate directly from the IGenericRepository
private IGenericRepository<Entities.Category> _categoryRepository;
private IGenericRepository<Entities.ProductStatusType> _productStatusTypeRepository; public LookupBS(IGenericRepository<Entities.Category> cateoryRepository, IGenericRepository<Entities.ProductStatusType> productStatusTypeRepository)
{ this._categoryRepository = cateoryRepository; this._productStatusTypeRepository = productStatusTypeRepository;
}

.NET Core DAL的GenericRepository实例不能由BLL项目中的类直接使用，因为它需要实例化的数据上下文StoreDbContext，而不是基本DbContext，才能注入到GenericRepository中。为了在LookupBS.cs中保持几乎相同的代码行，我们需要带有空成员的新IStoreLookupRepository.cs，和带有仅用于其构造函数代码的StoreLookupRepository.cs：

public interface IStoreLookupRepository<TEntity> : IGenericRepository<TEntity>  where TEntity : class
{
}public class StoreLookupRepository<TEntity> : GenericRepository<TEntity>, IStoreLookupRepository<TEntity> where TEntity : class
{ //Just need to pass db context to GenericRepository. public StoreLookupRepository(StoreDataContext context) : base(context) {            }
}

然后在LookupBS.cs中，只需将文本“GenericRepository”替换为“StoreLookupRepository”。现在，它的工作原理与从ASP.NET Web API迁移到ASP.NET Core之前的工作相同。

var query = storeDBContext.Products.GroupJoin(storeDBContext.Categories,p => p.CategoryId, c => c.CategoryId,(p, c) => new { p, c }).GroupJoin(storeDBContext.ProductStatusTypes,p1 => p1.p.StatusCode, s => s.StatusCode,(p1, s) => new { p1, s }).SelectMany(p2 => p2.s.DefaultIfEmpty(), (p2, s2) => new { p2 = p2.p1, s2 = s2 }).Select(f => new Models.ProductCM{ProductId = f.p2.p.ProductId,ProductName = f.p2.p.ProductName,CategoryId = f.p2.p.CategoryId,CategoryName = f.p2.p.Category.CategoryName,UnitPrice = f.p2.p.UnitPrice,StatusCode = f.p2.p.StatusCode,StatusDescription = f.s2.Description,AvailableSince = f.p2.p.AvailableSince});

当LINQ表达式更改为对SQL OUTTER JOIN场景使用“ from...join...select”语法时，该代码适用于EF Core 3.0 。

var query =from pr in storeDBContext.Productsjoin ca in storeDBContext.Categorieson pr.CategoryId equals ca.CategoryIdjoin ps in storeDBContext.ProductStatusTypeson pr.StatusCode equals ps.StatusCode into tempJoinfrom t2 in tempJoin.DefaultIfEmpty()select new Models.ProductCM{ProductId = pr.ProductId,ProductName = pr.ProductName,CategoryId = pr.CategoryId,CategoryName = ca.CategoryName,UnitPrice = pr.UnitPrice,StatusCode = pr.StatusCode,StatusDescription = t2.Description,AvailableSince = pr.AvailableSince};

此更改还会影响代码的其他部分。在SM.Store.Api.Common/GenericSorterPager.cs和SM.Store.Api.Commo/GenericMultiSorterPager.cs中，GetSortedPagedList()方法中的退出代码调用用于返回结果集中独特数据项的IQureryable.Distinct()方法。

public static IList<T> GetSortedPagedList<T>(IQueryable<T> source, PaginationRequest paging)
{- - -          source = source.Distinct();- - -
}

使用“ from...join...select”语法的更改要求将默认值添加OrderBy到LINQ查询。否则，如果有任何调用不包含排序请求，它将呈现错误“ ORDER BY items must appear in the select list if SELECT DISTINCT is specified”。需要将以下代码段添加到传递给GetSortedPagedList()方法调用的IQueryable源中，以按主键将select列表排序为默认设置。

if (paging != null && (paging.Sort == null || string.IsNullOrEmpty(paging.Sort.SortBy)))
{paging.Sort = new Models.Sort() {SortBy = "ProductId"};
}

执行存储过程

var result = this.Database.SqlQuery<Models.ProductCM>("dbo.GetPagedProductList " +"@FilterString, @SortString, @PageNumber, @PageSize, @TotalCount OUT",_filterString, _sortString, _pageNumber, _pageSize, _totalCount).ToList();

//Needed for calling stored procedures with .NET Core 2.0 EF.
public DbSet<Models.ProductCM> ProductCM_List { get; set; }

[NotMapped]
public partial class ProductCM
{[Key]public int ProductId { get; set; }public string ProductName { get; set; }- - -
}

var result = this.ProductCM_List.FromSql("dbo.GetPagedProductList " +"@FilterString, @SortString, @PageNumber, @PageSize, @TotalCount OUT",_filterString, _sortString, _pageNumber, _pageSize, _totalCount).ToList();

protected override void OnModelCreating(ModelBuilder builder)
{- - -//For GetProductListSp.builder.Query<Models.ProductCM>();
}

然后使用Query<T>()在GetProductListSp()中调用存储过程的方法，如下：

var result = this.Query<Models.ProductCM>().FromSql("dbo.GetPagedProductList " +"@FilterString, @SortString, @PageNumber, @PageSize, @TotalCount OUT",_filterString, _sortString, _pageNumber, _pageSize, _totalCount).ToList();

var result = this.ProductCMs.FromSqlRaw("dbo.GetPagedProductList " +"@FilterString, @SortString, @PageNumber, @PageSize, @TotalCount OUT",_filterString, _sortString, _pageNumber, _pageSize, _totalCount).ToList();

该ProductCMs声明为无PK关键的Dbset<T>属性。

public DbSet<Models.ProductCM> ProductCMs { get; set; }- - -protected override void OnModelCreating(ModelBuilder builder)
{- - -    builder.Entity<Models.ProductCM>().HasNoKey();
}

尽管可以正常工作，但对于使用EF Core 3.0执行存储过程的方法，我仍然有两个负面评论。

public bool BindModel(HttpActionContext actionContext, ModelBindingContext bindingContext)
{ //Check and get source data from uri if (!string.IsNullOrEmpty(actionContext.Request.RequestUri.Query)) {                kvps = actionContext.Request.GetQueryNameValuePairs().ToList(); } //Check and get source data from body else if (actionContext.Request.Content.IsFormData()) {                var bodyString = actionContext.Request.Content.ReadAsStringAsync().Result; try { kvps = ConvertToKvps(bodyString); } catch (Exception ex) { bindingContext.ModelState.AddModelError(bindingContext.ModelName, ex.Message); return false; } } else { bindingContext.ModelState.AddModelError(bindingContext.ModelName, "No input data"); return false; }            //Initiate primary object var obj = Activator.CreateInstance(bindingContext.ModelType); try {                //First call for processing primary object SetPropertyValues(obj); } catch (Exception ex) { bindingContext.ModelState.AddModelError( bindingContext.ModelName, ex.Message); return false; } //Assign completed object tree to Model bindingContext.Model = obj; return true;
}

在新版SM.Store.CoreApi中的BindModeAsync()方法似乎比ASP.NET Web API版本更简洁：

public Task BindModelAsync(ModelBindingContext bindingContext)
{    //Check and get source data from query string. if (bindingContext.HttpContext.Request.QueryString != null) { kvps = bindingContext.ActionContext.HttpContext.Request.Query.ToList();     } //Check and get source data from request body (form). else if (bindingContext.HttpContext.Request.Form != null) { try { kvps = bindingContext.ActionContext.HttpContext.Request.Form.ToList(); } catch (Exception ex) { bindingContext.ModelState.AddModelError(bindingContext.ModelName, ex.Message);} } else { bindingContext.ModelState.AddModelError(bindingContext.ModelName, "No input data");}            //Initiate primary object var obj = Activator.CreateInstance(bindingContext.ModelType); try {                //First call for processing primary object SetPropertyValues(obj);//Assign completed object tree to Model and return it. bindingContext.Result = ModelBindingResult.Success(obj); } catch (Exception ex) { bindingContext.ModelState.AddModelError( bindingContext.ModelName, ex.Message);               } return Task.CompletedTask;
}

从... Request.Query.ToList()和… Request.Form.ToList()返回的KeyValuePair（kvps）类型现在是List<KeyValuePair<string, StringValues>>而不是List<KeyValuePair<string, string>>。因此，任何相关的参考和代码行都需要相应地更改，主要是针对对象声明和赋值：

List<KeyValuePair<string, StringValues>> kvpsWork;
- - -
kvpsWork = new List<KeyValuePair<string, StringValues>>(kvps);

进行这些更改之后，ASP.NET Core模型绑定程序的所有功能都与旧版本相同。可下载的AspNetCore2.0-2.2_DataServices和AspNetCore3.0_DataServices中包含的文件TestCasesForDataServices_*.txt 中提供了更多测试用例。您可以将带有查询字符串的任何URL输入到Postman的请求输入区域，然后单击“发送”按钮。响应部分将显示基于查询字符串的复杂对象结构和值。

http://localhost:5112/api/getproductlist?ProductSearchFilter[0]
ProductSearchField=CategoryID&ProductSearchFilter[0]ProductSearchText=2&PaginationRequest[0]
PageIndex=0&PaginationRequest[0]PageSize=10&PaginationRequest[0]SortList[0]SortItem[0]
SortBy=StatusDescription&PaginationRequest[0]SortList[0]SortItem[0]
SortDirection=desc&PaginationRequest[0]SortList[1]SortItem[1]
SortBy=ProductName&PaginationRequest[0]SortList[1]SortItem[1]SortDirection=asc

FieldValueModelBinder的结构和代码在.NET Core 2x和3.0版之间兼容。这些版本之间没有重大变化。

"C:\Program Files\IIS Express\iisexpress.exe" /site:SM.Store.Api.Web/config:"<your <code>SM.Store.WebApi</code> path>\.vs\config\applicationhost.config"

IIS Express的相同命令行执行不适用于该SM.Store.CoreApi应用程序，因为它在与IIS Express工作进程分开的控制台应用程序进程中运行。如果您希望SM.Store.CoreApi和IIS Express 保持运行状态，以便在开发环境中向多个客户端提供数据服务，只需执行以下步骤：

--Create login and user.
USE master
GO
CREATE LOGIN WebUser WITH PASSWORD = 'password123',
DEFAULT_DATABASE = [StoreCF8],
CHECK_POLICY = OFF,
CHECK_EXPIRATION = OFF;
GOUSE StoreCF8
GO
IF NOT EXISTS (SELECT * FROM sys.database_principals WHERE name = N'WebUser')
BEGINCREATE USER [WebUser] FOR LOGIN [WebUser]EXEC sp_addrolemember N'db_datareader', N'WebUser'EXEC sp_addrolemember N'db_datawriter', N'WebUser'EXEC sp_addrolemember N'db_ddladmin', N'WebUser'
END;
GO GRANT EXECUTE TO WebUser;
GO

上面的脚本包含在来自下载源的StoreCF8.sql文件中。您实际上可以在此文件中运行整个脚本，以使用登录用户创建SQL Server数据库，然后在SQL Server实例的SM.Store.CoreApi发布文件夹下的appsettings.json文件中启用或更新连接字符串：

"ConnectionStrings": { "StoreDbConnection": "Server=<your SQL Server instance>;Database=StoreCF8;User Id=WebUser;Password=password123;MultipleActiveResultSets=true;"
}

您还需要在appsettings.json文件中为内存数据库删除此行（或将值“true”替换为“false”）：

"UseInMemoryDatabase": "true"

具有本地IIS和SQL Server数据库的SM.Store.CoreApi应用程序现在应该可以在本地计算机上运行。