ASP.NET Core 1.0 开发记录
ASP.NET Core 1.0 更新比較快（可能后面更新就不大了），閱讀注意時間節點，這篇博文主要記錄用 ASP.NET Core 1.0 開發簡單應用項目的一些記錄，以備查閱。
ASP.NET Core 1.0 相關 Nuget 程序包源：https://api.nuget.org/v3/index.json
閱讀目錄：
理解 .NET Platform Standard
Startup 配置
Sample.BootStrapper.Startup 配置
ASP.NET Core 1.0 Startup 配置
UnitTest 單元測試
類庫項目單元測試
WebApi 項目單元測試
Microsoft.EntityFrameworkCore
基本配置（MySql）
ModelBuilderExtenions 擴展
記錄執行 SQL
EntityFrameworkCore 遷移
CLI 命令
1. 理解 .NET Platform Standard
在用 ASP.NET Core 1.0 開發之前，理解 .NET Platform Standard（.NET 平臺標準）是非常有必要的，因為部署是跨平臺的，ASP.NET Core 1.0 應用程序的配置不同，部署環境也會不同，并且項目之間的兼容也會存在一些問題。
.NET Platform Standard 列表（2016 上半年）：
| .NET Platform Standard | netstandard | 1.0 | 1.1 | 1.2 | 1.3 | 1.4 | 1.5 | 1.6 |
| .NET Core | netcoreapp | → | → | → | → | → | → | 1.0 |
| .NET Framework | net | → | → | → | → | → | → | 4.6.3 |
| → | → | → | → | → | 4.6.2 | |||
| → | → | → | → | 4.6.1 | ||||
| → | → | → | 4.6 | |||||
| → | → | 4.5.2 | ||||||
| → | → | 4.5.1 | ||||||
| → | 4.5 | |||||||
| Universal Windows Platform | uap | → | → | → | → | 10.0 | ||
| Windows | win | → | → | 8.1 | ||||
| → | 8.0 | |||||||
| Windows Phone | wpa | → | → | 8.1 | ||||
| Windows Phone Silverlight | wp | 8.1 | ||||||
| 8.0 | ||||||||
| Mono/Xamarin Platforms | → | → | → | → | → | → | * | |
| Mono | → | → | * |
上面圖表時間雖然有點老，但和現在的發展是一樣的，只不過版本有所更新，主要的三個平臺：
.NET Platform Standard（netstandard）：.NET 平臺標準，或者稱為 .NET 通用平臺，是 .NET 部署所有平臺的一種通用標準規范（包含 Windows、Mac、Linux 等），建議使用，現在最新版本是 1.6 （2.0 版本快發布）。
.NET Core（netcoreapp）：.NET Core SDK running on CoreCLR/CoreFx，簡單來說，可以跑在安裝 CoreCLR/CoreFx 的任何平臺上（包含 Windows、Mac、Linux 等），前提必須是有 .NET Core 的運行環境，建議使用，現在最新版本是 1.1.0
.NET Framework（net）：.Net Framework SDK running on Desktop CLR / Full BCL and FCL，簡單來說，只能跑在 Windows 平臺上，不建議使用，最新版本是 4.6.3。
我們在開發 ASP.NET Core 1.0 應用程序的時候，一般是選擇netstandard或netcoreapp版本，并且這兩個平臺版本是相互兼容的，分別看一下示例：
netstandard1.6平臺：
{"version": "1.0.0","dependencies": {"Microsoft.EntityFrameworkCore": "1.0.0","NETStandard.Library": "1.6.1"},"frameworks": {"netstandard1.6": {"imports": "dnxcore50"}}}"imports": "dnxcore50" 的意思是兼容之前dnxcore50平臺（dnxcore50現在已被廢棄，并被netcoreapp取代），比如你之前有個類庫是用dnxcore50平臺開發的，現在使用netstandard平臺開發的類庫，如果不添加此配置，是會報錯的。
"NETStandard.Library": "1.6.1"包含了一系列和netstandard相關的 Nuget 程序包，配置netstandard平臺，必須添加此配置，如果沒有的話，.NET 基礎的命名空間是訪問不到的。
netcoreapp1.1.0平臺：
{"version": "1.0.0","dependencies": {"Microsoft.EntityFrameworkCore": "1.0.0"},"frameworks": {"netcoreapp1.1.0": {"dependencies": {"Microsoft.NETCore.App": {"type": "platform","version": "1.1.0"}}},"imports": ["dotnet5.6","portable-net45+win10"]}}}netstandard1.1.0平臺和上面netstandard1.6平臺配置差不多，Microsoft.NETCore.App 和 NETStandard.Library 是一樣目的，dotnet5.6和dnxcore50一樣，都是 .NET Core 之前平臺的廢棄代號。
portable 的意思是便攜型，如果添加了此配置，表示應用程序發布部署不攜帶依賴的程序包，而是使用系統中安裝配置的。
還有一點需要注意的是，netcoreapp1.1.0平臺和netstandard1.6平臺開發是相互兼容的，比如我們開發一些自己的 Nuget 程序包，使用的平臺版本可以是上面兩個，但最好是使用netstandard低一點的版本，因為以后netstandard可能是微軟平臺的一種標準規范，比如我現在開發 Nuget 程序包平臺使用netcoreapp1.1.0，ASP.NET Core 1.0 應用程序使用netcoreapp1.1.0平臺，后者就可以引用前者，因為第三方 Nuget 程序包使用平臺版本可能比較低，所以我們開發的 ASP.NET Core 1.0 應用程序平臺版本也相應低一些。
2. Startup 配置
Startup 需要添加額外的配置，以便于單元測試的進行，比如 EF、依賴注入和 AutoMapper 配置，需要獨立進行配置，而不是放在 ASP.NET Core 1.0 應用程序中的 Startup 配置中。
2.1 Sample.BootStrapper.Startup 配置
比如這樣的一個項目 Sample.BootStrapper：
project.json 配置：
{"version": "1.0.0-*","dependencies": {"System.ComponentModel.Primitives": "4.1.0","Microsoft.NETCore.App": ""},"frameworks": {"netcoreapp1.1.0": {"dependencies": {"Microsoft.NETCore.App": {"type": "platform","version": "1.1.0"}}}}}上面代碼主要是對 IServiceCollection 的 Configure 方法進行了擴展，這樣對 Domain、Repository 和 AppliactionService 進行獨立的單元測試了，只需要在構造函數中進行添加調用即可，后面再說這一點。
2.2 ASP.NET Core 1.0 Startup 配置
另外，ASP.NET Core 1.0 應用程序的 Startup 示例代碼：
public class Startup { ? ?public Startup(IHostingEnvironment env){#if DEBUG ? ? ? ?var path = Directory.GetCurrentDirectory();#elsevar path = env.ContentRootPath;#endifvar builder = new ConfigurationBuilder().SetBasePath(path).AddJsonFile("appsettings.json", optional: true, reloadOnChange: true).AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true).AddEnvironmentVariables();Configuration = builder.Build();Log.Logger = new LoggerConfiguration().MinimumLevel.Error().WriteTo.RollingFile(Path.GetFullPath("logs/log-{Date}.txt")).CreateLogger();} ? ?public IConfigurationRoot Configuration { get; } ? ?? ? ?
? ? ?// This method gets called by the runtime. Use this method to
? ? ? add services to the container.public void ConfigureServices(IServiceCollection services){ ?// Add framework services.// 配置 WebApi 返回 Json 數據大小寫問題，默認數據會首字母小寫。services.AddMvc().AddJsonOptions(options =>
? ? ? options.SerializerSettings.ContractResolver = new DefaultContractResolver()); ?
?? ? ?// 注意這里services.Configure(Configuration["data:ConnectionString"]);} ?
? ?// This method gets called by the runtime. Use this method to configure the
? ? ? ? ? ? ?HTTP request pipeline.public void Configure(IApplicationBuilder app, IHostingEnvironment env,
? ? ? ? ?ILoggerFactory loggerFactory){loggerFactory.AddSerilog();loggerFactory.AddConsole(Configuration.GetSection("Logging"));loggerFactory.AddDebug();app.UseStaticFiles();app.UseMvc();} }
日志服務使用的是 Serilog，日志級別有多種進行選擇（可以 Debug、Error 等），日志和連接字符串的配置可以放在 appsettings.json 文件中，ConfigureServices 里面調用 Sample.BootStrapper.StartUp 的配置。
project.json 示例代碼：
{"dependencies": {"Microsoft.AspNetCore.Mvc": "1.0.1","Microsoft.AspNetCore.Routing": "1.0.1","Microsoft.AspNetCore.Server.IISIntegration": "1.0.0","Microsoft.AspNetCore.Server.Kestrel": "1.0.1","Microsoft.Extensions.Configuration.EnvironmentVariables": "1.0.0","Microsoft.Extensions.Configuration.FileExtensions": "1.0.0","Microsoft.Extensions.Configuration.Json": "1.0.0","Microsoft.Extensions.Logging": "1.1.0","Microsoft.Extensions.Logging.Console": "1.0.0","Microsoft.Extensions.Logging.Debug": "1.0.0","Microsoft.Extensions.Options.ConfigurationExtensions": "1.0.0","Microsoft.AspNetCore.Cors": "1.0.0","Serilog": "2.3.0","Serilog.Extensions.Logging":"1.3.1","Serilog.Sinks.RollingFile": "3.2.0","Microsoft.AspNetCore.StaticFiles": "1.0.0","Sample.BootStrapper": "1.0.0-*","Microsoft.EntityFrameworkCore.Design": {"type": "build","version": "1.0.0-preview2-final"}},"tools": {"Microsoft.EntityFrameworkCore.Tools": "1.0.0-preview2-final","Microsoft.AspNetCore.Server.IISIntegration.Tools": "1.0.0-preview2-final"},"frameworks": {"netcoreapp1.0.1": {"dependencies": {"Microsoft.NETCore.App": {"type": "platform","version": "1.0.1"}},"imports": ["dotnet5.6","portable-net45+win10"]}},"buildOptions": {"emitEntryPoint": true,"preserveCompilationContext": true},"runtimeOptions": {"configProperties": {"System.GC.Server": true}},"publishOptions": {"include": ["wwwroot","**/*.cshtml","appsettings.json","web.config"]},"scripts": {"postpublish": [ "dotnet publish-iis --publish-folder %publish:OutputPath%? ? ? ? ? ?--framework %publish:FullTargetFramework%" ]}}
appsettings.json 示例代碼：
{"data": {"ConnectionString": ""},"Logging": {"IncludeScopes": false,"LogLevel": {"Default": "Error","System": "Information","Microsoft": "Information"}}}另外，在 Program.cs 中可以配置選擇服務器，比如 IIS 或 Kestrel 等。
3. UnitTest 單元測試
相關文章：
Getting started with xUnit.net (.NET Core / ASP.NET Core)
Integration Testing
單元測試主要包含兩方面：類庫項目單元測試和 WebApi 項目單元測試。
3.1 類庫項目單元測試
類庫項目單元測試代碼示例：
provider.GetService 手動獲取依賴注入的對象，ITestOutputHelper 的目的是取代Console.WriteLine（因為不支持），但現在 ITestOutputHelper 好像也輸出不了，之前 RC2 的時候是可以的，不知道啥原因。
3.1 WebApi 項目單元測試
WebApi 項目單元測試示例代碼：
RC2 版本是無法對 WebApi 進行單元測試的，因為 TestHost 不支持，現在 ASP.NET Core 1.0 版本和 ASP.NET WebApi 2 是差不多的了，使用也很方便，不過 HttpClient 沒有了 PostAsJsonAsync 方法，需要使用 JsonConvert 手動轉換一下。
project.json 配置代碼：
{"version": "1.0.0-*","testRunner": "xunit","dependencies": {"xunit": "2.2.0-beta4-build3444","dotnet-test-xunit": "2.2.0-preview2-build1029","Microsoft.AspNetCore.TestHost": "1.0.0","Microsoft.Extensions.DependencyInjection": "1.1.0","Sample.BootStrapper": "1.0.0-*","Sample.WebApi": "1.0.0-*"},"frameworks": {"netcoreapp1.0.1": {"dependencies": {"Microsoft.NETCore.App": {"type": "platform","version": "1.0.1"}},"imports": ["dotnet5.6","portable-net45+win10"]}}}我之前用netstandard1.6平臺，但配置 xunit 的時候，發現不支持最新的版本，后來就該用了netcoreapp1.0.1，testRunner 配置后可以在 Test Explorer 窗口中看到單元測試，也可以在方法的窗口上看到，主要用于調試目的。
單元測試命令：dotnet test
4. Microsoft.EntityFrameworkCore
相關資料：Entity Framework Core
4.1 基本配置
Microsoft.EntityFrameworkCore 和 EntityFramework 7 的用法差不多，現在項目使用的 MySql 數據庫，示例配置代碼：
4.2 ModelBuilderExtenions 擴展
AddEntityConfigurationsFromAssembly 是對 ModelBuilder 的擴展，這樣如果有多個實體映射配置，OnModelCreating 中只需要一行代碼就可以了，擴展代碼：
project.json 示例代碼：
{"version": "1.0.0-*","dependencies": {"MySql.Data.EntityFrameworkCore": "7.0.6-IR31","MySql.Data": "7.0.6-IR31","System.Reflection.TypeExtensions": "4.3.0","Microsoft.Extensions.DependencyInjection": "1.1.0"},"frameworks": {"netcoreapp1.0.1": {"dependencies": {"Microsoft.NETCore.App": {"type": "platform","version": "1.0.1"}}}}}EntityFrameworkCore 針對 MySql 微軟沒有開放相應的 Nuget 程序包，第三方有很多的程序包，但或多或少的有些問題，MySql.Data.EntityFrameworkCore 是 EntityFrameworkCore GitHub Issue 中出現最多的，并且是 MySql 自己開發的，所以使用的話沒什么問題。
如果在查詢的時候報這個錯誤：
System.MissingMethodException was unhandled
HResult=-2146233069
Message=Method not found: 'Void Microsoft.EntityFrameworkCore.Query.QueryContextFactory..ctor(Microsoft.EntityFrameworkCore.ChangeTracking.Internal.IStateManager, Microsoft.EntityFrameworkCore.Internal.IConcurrencyDetector, Microsoft.EntityFrameworkCore.ChangeTracking.Internal.IChangeDetector)'.
Source=Microsoft.EntityFrameworkCore.Relational
StackTrace:
at Microsoft.EntityFrameworkCore.Query.Internal.RelationalQueryContextFactory..ctor(IStateManager stateManager, IConcurrencyDetector concurrencyDetector, IRelationalConnection connection, IChangeDetector changeDetector)
--- End of stack trace from previous location where exception was thrown ---
解決方式是引用 MySql.Data.EntityFrameworkCore 程序包的類庫，移除 Microsoft.EntityFrameworkCore 程序包，參考資料：MissingMethodException DbSet.ToList
4.3 記錄執行 SQL
另外，關于 EntityFrameworkCore 如何記錄執行 SQL，Google 找了好久也沒找到好的解決方案，最后找到了一個別人寫的 IQueryable 擴展方法：
調用示例：
var query = _productRepository.Get(1);var sql = query.ToSql(); Console.WriteLine(sql);不過暫時只能輸出單表查詢的，多表關聯查詢的執行 SQL 輸出不了。
4.4 EntityFrameworkCore 遷移
相關文章：
EntityFramework 7 Migrations 遷移命令
EntityFrameworkCore Migrations
相對于 EntityFramework 7，EntityFrameworkCore 遷移改變很多，
首先，ASP.NET Core 1.0 project.json 中添加如下配置：
{"dependencies": {"Microsoft.EntityFrameworkCore.Design": {"type": "build","version": "1.0.0-preview2-final"}},"tools": {"Microsoft.EntityFrameworkCore.Tools": "1.0.0-preview2-final"},"frameworks": {"netcoreapp1.0.1": { }}}Sample.BootStrapper.Startup 中 Configure 修改如下：
public static void Configure(this IServiceCollection services, string connectionString) {services.AddDbContext<CommodityDbContext>(options =>options.UseMySQL(connectionString, b => b.MigrationsAssembly("Sample.WebApi"))? ? ? ? ?//添加 MigrationsAssembly); ? ?///to do...
然后 CMD 直接切換到 Sample.WebApi 文件目錄下，執行如下命令：
dotnet ef migrations add 名稱
dotnet ef database update
5. CLI 命令
相關資料：.NET Core 命令行接口工具
dotnet 具有以下命令：
dotnet new：初始化 C# 或 F # 控制臺應用程序項目。
dotnet restore：還原給定應用程序的依賴項。
dotnet build：生成 .NET Core 應用程序。
dotnet publish：發布 .NET 可移植或獨立應用程序。
dotnet run：從源運行應用程序。
dotnet test：使用 project.json 中指定的測試運行程序運行測試。
dotnet pack：創建代碼的 NuGet 包。
CLI 還支持持續集成，不過沒試過，我第一次用 dotnet pack，結合 Nuget Package Explorer 可以很方便的發布管理程序包。
原文地址：http://www.cnblogs.com/liubingbing/p/6343701.html
.NET社區新聞，深度好文，微信中搜索dotNET跨平臺或掃描二維碼關注
總結
以上是生活随笔為你收集整理的ASP.NET Core 1.0 开发记录的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： C# 7.0新功能
- 下一篇： 新春大吉，2017 Make .NET