ASP.NET 5运行时升级到Beta5

时间:2022-04-23
本文章向大家介绍ASP.NET 5运行时升级到Beta5,主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

在Visual Studio 2015 RTM和Windows 10正式发布之前,微软把开源.NET升级到了beta5,带来了一些增强和改变。和Visual Studio 2015 RC一起安装的ASP.NET 5运行时是beta4,前几天微软发布了这个运行时的beta5版本。整个升级包括如下几个方面:

  • .NET执行环境(DNX)
    • 支持Nuget v3,恢复包的速度更快
    • 支持全新的.NET目标框架监测器(TFM)
    • 在project.json中可以设置语言和发布说明的链接
    • 消除了JSON.NET的固定版本要求:即不再要求你的应用程序使用和DNX一致的JSON.NET版本
    • 新的IRuntimeEnvironment服务
  • ASP.NET 5函数库
    • HttpContext.Connection,通过HttpContext可以获得连接的信息
    • 提供了本地化的抽象和中间件,且提供了示例帮助大家了解用法
    • 统一终止ASP.NET宿主环境的快捷键为Ctrl+C
  • MVC 6
    • 在Razor支持C# 6的新特性
    • 简化了MVC的选项设置,添加了顶级配置
    • 在视图中可以使用JSON Helper来序列化数据模型
    • 在Route标记中能够使用通配替换
    • 新的ImageTagHelper
    • Tag Helper支持绑定字典属性
    • Tag Helper支持条件绑定

ASP.NET 5 Beta5 Now Available中不仅详细介绍了上述增强,也给出了一个大致的升级步骤, 同时也给出了一个破坏变更的列表,主要的变化是Configuration部分的命名空间改变和程序集的整理,以及Entity Framework 7数据迁移的变化。具体参见:https://github.com/aspnet/announcements/issues?q=milestone%3A1.0.0-beta5

把ASP.NET 5的项目代码从beta 4升级到beta5遵从了文章ASP.NET 5 Beta5 Now Available文章中提到的基本步骤。

1,安装或升级DNVM。

如果没有.NET Version Manager (DNVM),需要通过如下代码来安装(如果已经有了执行如下代码也会升级到最新版本):

1: @powershell -NoProfile -ExecutionPolicy unrestricted -Command "&{$Branch='dev';iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.ps1'))}"

理论上,执行以上代码就可以把dnvm安装(或升级)到"beta6-10395",明显的不同是多了一个"update-self"的命令。

如果在已经有beta4的dnvm,那么执行上述命令后,需要重启命令行窗口才能看到最新的dnvm版本;当然我也遇到一个奇怪的问题,就是执行上述代码后死活不能升级,最后无奈,只好先执行第二步(见:升级DNX运行时)的特殊步骤,然后就会看到dnvm也自动升级为最新版本了。

2,升级DNX运行时。

如果正常升级了DNVM,那么无需去设置"DNX_FEED"环境变量,因为最新版的DNVM的默认地址已经是"https://www.nuget.org/api/v2"。现在只需要执行"dnvm upgrade"就可以下载并安装ASP.NET 5的Beta5运行时了(默认是clr x86),也会自动把这个运行时设置激活状态和default别名。

当然如果没有升级DNVM,那么可以设置"DNX_FEED",然后再升级DNX运行时。

也可以不设置"DNX_FEED",直接执行"dnvm upgrade",来先升级到beta5的预发布版本(beta5-12103)。升级到beta5的预发布版本会同时升级dnvm,然后再次执行"dnvm upgrade",升级到beta5正式发布版本。(这里说的就是上面提到的特殊步骤)。

3,修改project.json中的包引用。

打开解决方案中所有项目的project.json文件的,把其中所有后缀"beta4"的包修改为"beta5",保存project.json文件后,VS会自动更新到最新的beta5的包。

需要注意的是,xunit的相关包要改为引用beta5的编译版本,即"xunit": "2.1.0-beta3-build3029","xunit.runner.dnx": "2.1.0-beta3-build99"。

和Configuration相关的包,从"Microsoft.Framework.ConfigurationModel"修改为"Microsoft.Framework.Configuration"。

把"Interfaces"后缀的包修改为"Abstractions"。

4,解决代码变更。根据更新尤其破坏变更列表(https://github.com/aspnet/announcements/issues?q=milestone%3A1.0.0-beta5),来修改编译有问题的代码。主要的修改有:

  • EF7的迁移修改了代码接口(从属性改为方法),为了避免大量修改代码我是自己重建Migration。如果需要修改,见:https://github.com/aspnet/Announcements/issues/35
  • 把命名空间"Microsoft.Framework.ConfigurationModel"修改为"Microsoft.Framework.Configuration"。
  • IConfiguration.GetSubKey修改为IConfiguration.GetConfigurationSection
  • _GlobalImport.cshtml重命名为_ViewImports.cshtml,修改后VS2015可能会报类型没有引用,不必理会(等着VSWebTools更新)
  • 我之前讲解EF数据迁移的文章提到的代码"db.Database as SqlServerDatabase"要改为"db.Database as RelationalDatabase"
  • 单元测试中,必须显式执行services.AddLogging()