Migrating from ASP.NET Core RC2 to ASP.NET Core 1.0

By Cesar Blum Silveira

Overview

This migration guide covers migrating an ASP.NET Core RC2 application to ASP.NET Core 1.0.

There weren’t many significant changes to ASP.NET Core between the RC2 and 1.0 releases. For a complete list of changes, see the ASP.NET Core 1.0 announcements.

Install the new tools from https://dot.net/core and follow the instructions.

Update the global.json to

{
  "projects": [ "src", "test" ],
  "sdk": {
      "version": "1.0.0-preview2-003121"
  }
}

Tools

For the tools we ship, you no longer need to use imports in project.json. For example:

{
  "tools": {
    "Microsoft.AspNetCore.Server.IISIntegration.Tools": {
      "version": "1.0.0-preview1-final",
      "imports": "portable-net45+win8+dnxcore50"
    }
  }
}

Becomes:

{
  "tools": {
    "Microsoft.AspNetCore.Server.IISIntegration.Tools": "1.0.0-preview2-final"
  }
}

Hosting

The UseServer is no longer available for IWebHostBuilder. You must now use UseKestrel or UseWebListener.

ASP.NET MVC Core

The HtmlEncodedString class has been replaced by HtmlString (contained in the Microsoft.AspNetCore.Html.Abstractions package).

Security

The AuthorizationHandler<TRequirement> class now only contains an asynchronous interface.