71 lines
2.7 KiB
Markdown
71 lines
2.7 KiB
Markdown
---
|
|
title: Migrating from ASP.NET Core RC2 to ASP.NET Core 1.0
|
|
author: rick-anderson
|
|
ms.author: riande
|
|
manager: wpickett
|
|
ms.date: 10/14/2016
|
|
ms.topic: article
|
|
ms.assetid: b672bd6e-7ecf-4504-9ecf-58ae9ec0153f
|
|
ms.prod: aspnet-core
|
|
uid: migration/rc2-to-rtm
|
|
---
|
|
# Migrating from ASP.NET Core RC2 to ASP.NET Core 1.0
|
|
|
|
By [Cesar Blum Silveira](https://github.com/cesarbs)
|
|
|
|
## 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](https://github.com/aspnet/announcements/issues?q=is%3Aopen+is%3Aissue+milestone%3A1.0.0).
|
|
|
|
Install the new tools from [https://dot.net/core](https://dot.net/core) and follow the instructions.
|
|
|
|
Update the global.json to
|
|
|
|
````javascript
|
|
{
|
|
"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:
|
|
|
|
````json
|
|
{
|
|
"tools": {
|
|
"Microsoft.AspNetCore.Server.IISIntegration.Tools": {
|
|
"version": "1.0.0-preview1-final",
|
|
"imports": "portable-net45+win8+dnxcore50"
|
|
}
|
|
}
|
|
}
|
|
````
|
|
|
|
Becomes:
|
|
|
|
````json
|
|
{
|
|
"tools": {
|
|
"Microsoft.AspNetCore.Server.IISIntegration.Tools": "1.0.0-preview2-final"
|
|
}
|
|
}
|
|
````
|
|
|
|
## Hosting
|
|
|
|
The `UseServer` is no longer available for [`IWebHostBuilder`](http://docs.asp.net/projects/api/en/latest/autoapi/Microsoft/AspNetCore/Hosting/IWebHostBuilder/index.html#Microsoft.AspNetCore.Hosting.IWebHostBuilder). You must now use [`UseKestrel`](http://docs.asp.net/projects/api/en/latest/autoapi/Microsoft/AspNetCore/Hosting/WebHostBuilderKestrelExtensions/index.html#Microsoft.AspNetCore.Hosting.WebHostBuilderKestrelExtensions.UseKestrel) or [`UseWebListener`](http://docs.asp.net/projects/api/en/latest/autoapi/Microsoft/AspNetCore/Hosting/WebHostBuilderWebListenerExtensions/index.html#Microsoft.AspNetCore.Hosting.WebHostBuilderWebListenerExtensions.UseWebListener).
|
|
|
|
## ASP.NET MVC Core
|
|
|
|
The `HtmlEncodedString` class has been replaced by [`HtmlString`](http://docs.asp.net/projects/api/en/latest/autoapi/Microsoft/AspNetCore/Html/HtmlString/index.html#Microsoft.AspNetCore.Html.HtmlString) (contained in the `Microsoft.AspNetCore.Html.Abstractions` package).
|
|
|
|
## Security
|
|
|
|
The [`AuthorizationHandler<TRequirement>`](http://docs.asp.net/projects/api/en/latest/autoapi/Microsoft/AspNetCore/Authorization/AuthorizationHandler-TRequirement/index.html#Microsoft.AspNetCore.Authorization.AuthorizationHandler<TRequirement>) class now only contains an asynchronous interface.
|