You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: aspnetcore/migration/1x-to-2x/index.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,7 +25,7 @@ See [Get Started with ASP.NET Core](xref:getting-started).
25
25
26
26
## Update Target Framework Moniker (TFM)
27
27
28
-
Projects targeting .NET Core should use the [TFM](/dotnet/standard/frameworks) of a version greater than or equal to .NET Core 2.0. Search for the `<TargetFramework>` node in the `.csproj` file, and replace its inner text with `netcoreapp2.0`:
28
+
Projects targeting .NET should use the [TFM](/dotnet/standard/frameworks) of a version greater than or equal to .NET 2.0. Search for the `<TargetFramework>` node in the `.csproj` file, and replace its inner text with `netcoreapp2.0`:
> .NET Core 2.0 offers a much larger surface area than .NET Core 1.x. If you're targeting .NET Framework solely because of missing APIs in .NET Core 1.x, targeting .NET Core 2.0 is likely to work.
37
+
> .NET 2.0 offers a much larger surface area than .NET 1.x. If you're targeting .NET Framework solely because of missing APIs in .NET 1.x, targeting .NET 2.0 is likely to work.
38
38
39
39
If the project file contains `<RuntimeFrameworkVersion>1.{sub-version}</RuntimeFrameworkVersion>`, see [this GitHub issue](https://github.com/dotnet/AspNetCore/issues/3221#issuecomment-413094268).
40
40
41
41
<aname="global-json"></a>
42
42
43
-
## Update .NET Core SDK version in global.json
43
+
## Update .NET SDK version in global.json
44
44
45
-
If your solution relies upon a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET Core SDK version, update its `version` property to use the 2.0 version installed on your machine:
45
+
If your solution relies upon a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET SDK version, update its `version` property to use the 2.0 version installed on your machine:
@@ -52,7 +52,7 @@ If your solution relies upon a [global.json](/dotnet/core/tools/global-json) fil
52
52
53
53
The `.csproj` file in a 1.x project lists each NuGet package used by the project.
54
54
55
-
In an ASP.NET Core 2.0 project targeting .NET Core 2.0, a single [metapackage](xref:fundamentals/metapackage) reference in the `.csproj` file replaces the collection of packages:
55
+
In an ASP.NET Core 2.0 project targeting .NET 2.0, a single [metapackage](xref:fundamentals/metapackage) reference in the `.csproj` file replaces the collection of packages:
@@ -170,11 +170,11 @@ Effortless setup of application performance instrumentation is important. You ca
170
170
171
171
ASP.NET Core 1.1 projects created in Visual Studio 2017 added Application Insights by default. If you're not using the Application Insights SDK directly, outside of `Program.cs` and `Startup.cs`, follow these steps:
172
172
173
-
1. If targeting .NET Core, remove the following `<PackageReference />` node from the `.csproj` file:
173
+
1. If targeting .NET, remove the following `<PackageReference />` node from the `.csproj` file:
Copy file name to clipboardExpand all lines: aspnetcore/migration/20_21.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,7 +31,7 @@ This article provides an overview on migration to ASP.NET Core 2.1. It doesn't c
31
31
32
32
Update the project file:
33
33
34
-
* Change the target framework to .NET Core 2.1 by updating the project file to `<TargetFramework>netcoreapp2.1</TargetFramework>`.
34
+
* Change the target framework to .NET 2.1 by updating the project file to `<TargetFramework>netcoreapp2.1</TargetFramework>`.
35
35
* Replace the package reference for `Microsoft.AspNetCore.All` with a package reference for `Microsoft.AspNetCore.App`. You may need to add dependencies that were removed from `Microsoft.AspNetCore.All`. For more information, see <xref:fundamentals/metapackage#migrate> and <xref:fundamentals/metapackage-app>.
36
36
* Remove the "Version" attribute on the package reference to `Microsoft.AspNetCore.App`. Projects that use `<Project Sdk="Microsoft.NET.Sdk.Web">` don't need to set the version. The version is implied by the target framework and selected to best match the way ASP.NET Core 2.1 works. For more information, see the [Rules for projects targeting the shared framework](#rules-for-projects-targeting-the-shared-framework) section.
37
37
* For apps that target the .NET Framework, update each package reference to 2.1.
@@ -64,7 +64,7 @@ The version specified by the package reference is the *minimum required* version
64
64
65
65
Known issues for projects targeting a shared framework:
66
66
67
-
* The .NET Core 2.1.300 SDK (first included in Visual Studio 15.6) set the implicit version of `Microsoft.AspNetCore.App` to 2.1.0 which caused conflicts with Entity Framework Core 2.1.1. The recommended solution is to upgrade the .NET Core SDK to 2.1.301 or later. For more information, see [Packages that share dependencies with Microsoft.AspNetCore.App cannot reference patch versions](https://github.com/aspnet/Universe/issues/1180).
67
+
* The .NET 2.1.300 SDK (first included in Visual Studio 15.6) set the implicit version of `Microsoft.AspNetCore.App` to 2.1.0 which caused conflicts with Entity Framework Core 2.1.1. The recommended solution is to upgrade the .NET SDK to 2.1.301 or later. For more information, see [Packages that share dependencies with Microsoft.AspNetCore.App cannot reference patch versions](https://github.com/aspnet/Universe/issues/1180).
68
68
* All projects that must use `Microsoft.AspNetCore.All` or `Microsoft.AspNetCore.App` should add a package reference for the package in the project file, even if they contain a project reference to another project using `Microsoft.AspNetCore.All` or `Microsoft.AspNetCore.App`.
Copy file name to clipboardExpand all lines: aspnetcore/migration/21-to-22.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,7 +31,7 @@ This article explains how to update an existing ASP.NET Core 2.1 project to ASP.
31
31
32
32
## Update Target Framework Moniker (TFM)
33
33
34
-
Projects targeting .NET Core should use the [TFM](/dotnet/standard/frameworks) of a version greater than or equal to .NET Core 2.2. In the project file, update the `<TargetFramework>` node's inner text with `netcoreapp2.2`:
34
+
Projects targeting .NET should use the [TFM](/dotnet/standard/frameworks) of a version greater than or equal to .NET 2.2. In the project file, update the `<TargetFramework>` node's inner text with `netcoreapp2.2`:
35
35
36
36
```xml
37
37
<TargetFramework>netcoreapp2.2</TargetFramework>
@@ -66,7 +66,7 @@ For more information and example *web.config* files, see <xref:host-and-deploy/a
66
66
67
67
## Update package references
68
68
69
-
If targeting .NET Core, remove the metapackage reference's `Version` attribute in the project file. Inclusion of a `Version` attribute results in the following warning:
69
+
If targeting .NET, remove the metapackage reference's `Version` attribute in the project file. Inclusion of a `Version` attribute results in the following warning:
70
70
71
71
```console
72
72
A PackageReference to 'Microsoft.AspNetCore.App' specified a Version of `2.2.0`. Specifying the version of this package is not recommended. For more information, see https://aka.ms/sdkimplicitrefs
@@ -100,9 +100,9 @@ If referencing the [Microsoft.AspNetCore.Razor.Design](https://www.nuget.org/pac
100
100
Detected package downgrade: Microsoft.AspNetCore.Razor.Design from 2.2.0 to 2.1.2. Reference the package directly from the project to select a different version.
101
101
```
102
102
103
-
## Update .NET Core SDK version in global.json
103
+
## Update .NET SDK version in global.json
104
104
105
-
If your solution relies upon a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET Core SDK version, update its `version` property to the 2.2 version installed on your machine:
105
+
If your solution relies upon a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET SDK version, update its `version` property to the 2.2 version installed on your machine:
Copy file name to clipboardExpand all lines: aspnetcore/migration/22-to-30.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,9 +32,9 @@ This article explains how to update an existing ASP.NET Core 2.2 project to ASP.
32
32
33
33
---
34
34
35
-
## Update .NET Core SDK version in global.json
35
+
## Update .NET SDK version in global.json
36
36
37
-
If your solution relies upon a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET Core SDK version, update its `version` property to the 3.0 version installed on your machine:
37
+
If your solution relies upon a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET SDK version, update its `version` property to the 3.0 version installed on your machine:
38
38
39
39
```json
40
40
{
@@ -48,7 +48,7 @@ If your solution relies upon a [global.json](/dotnet/core/tools/global-json) fil
48
48
49
49
### Update the Target Framework
50
50
51
-
ASP.NET Core 3.0 or later only run on .NET Core. Set the [Target Framework Moniker (TFM)](/dotnet/standard/frameworks) to `netcoreapp3.0`:
51
+
ASP.NET Core 3.0 or later only run on .NET. Set the [Target Framework Moniker (TFM)](/dotnet/standard/frameworks) to `netcoreapp3.0`:
@@ -293,7 +293,7 @@ In the preceding image, added code is shown in green. For information on the fol
293
293
294
294
Projects that target `Microsoft.NET.Sdk.Web` implicitly reference analyzers previously shipped as part of the [Microsoft.AspNetCore.Mvc.Analyzers](https://www.nuget.org/packages/Microsoft.AspNetCore.Mvc.Analyzers/) package. No additional references are required to enable these.
295
295
296
-
If your app uses [API analyzers](xref:web-api/advanced/analyzers) previously shipped using the [Microsoft.AspNetCore.Mvc.Api.Analyzers](https://www.nuget.org/packages/Microsoft.AspNetCore.Mvc.Api.Analyzers/) package, edit your project file to reference the analyzers shipped as part of the .NET Core Web SDK:
296
+
If your app uses [API analyzers](xref:web-api/advanced/analyzers) previously shipped using the [Microsoft.AspNetCore.Mvc.Api.Analyzers](https://www.nuget.org/packages/Microsoft.AspNetCore.Mvc.Api.Analyzers/) package, edit your project file to reference the analyzers shipped as part of the .NET Web SDK:
297
297
298
298
```xml
299
299
<ProjectSdk="Microsoft.NET.Sdk.Web">
@@ -455,7 +455,7 @@ Apps and libraries targeting ASP.NET Core 2.1 or later should remove any direct
455
455
456
456
As part of the work to [improve the ASP.NET Core shared framework](https://blogs.msdn.microsoft.com/webdev/2018/10/29/a-first-look-at-changes-coming-in-asp-net-core-3-0/), [Newtonsoft.Json (Json.NET)](https://www.newtonsoft.com/json/help/html/Introduction.htm) has been removed from the ASP.NET Core shared framework.
457
457
458
-
The default JSON serializer for ASP.NET Core is now <xref:System.Text.Json>, which is new in .NET Core 3.0. Consider using `System.Text.Json` when possible. It's high-performance and doesn't require an additional library dependency. However, since `System.Text.Json` is new, it might currently be missing features that your app needs. For more information, see [How to migrate from Newtonsoft.Json to System.Text.Json](/dotnet/standard/serialization/system-text-json-migrate-from-newtonsoft-how-to).
458
+
The default JSON serializer for ASP.NET Core is now <xref:System.Text.Json>, which is new in .NET 3.0. Consider using `System.Text.Json` when possible. It's high-performance and doesn't require an additional library dependency. However, since `System.Text.Json` is new, it might currently be missing features that your app needs. For more information, see [How to migrate from Newtonsoft.Json to System.Text.Json](/dotnet/standard/serialization/system-text-json-migrate-from-newtonsoft-how-to).
459
459
460
460
### Use Newtonsoft.Json in an ASP.NET Core 3.0 SignalR project
461
461
@@ -880,7 +880,7 @@ In ASP.NET Core 2.2, you could set the `TransportMaxBufferSize` and that would e
880
880
881
881
#### SignalR assemblies in shared framework
882
882
883
-
ASP.NETCoreSignalRserver-sideassembliesarenowinstalledwiththe .NETCoreSDK. Formoreinformation, see [Removeobsoletepackagereferences](#remove-obsolete-package-references) inthisdocument.
883
+
ASP.NETCoreSignalRserver-sideassembliesarenowinstalledwiththe .NETSDK. Formoreinformation, see [Removeobsoletepackagereferences](#remove-obsolete-package-references) inthisdocument.
884
884
885
885
### MVC controllers
886
886
@@ -1197,7 +1197,7 @@ For more information on using ASP.NET Core APIs in a class library, see <xref:fu
1197
1197
1198
1198
## Miscellaneous changes
1199
1199
1200
-
Thevalidationsystemin .NETCore3.0orlatertreatsnon-nullableparametersorboundpropertiesasiftheyhada `[Required]` attribute. Formoreinformation, see [[Required] attribute](xref:mvc/models/validation?view=aspnetcore-3.1#required-attribute).
1200
+
Thevalidationsystemin .NET3.0orlatertreatsnon-nullableparametersorboundpropertiesasiftheyhada `[Required]` attribute. Formoreinformation, see [[Required] attribute](xref:mvc/models/validation?view=aspnetcore-3.1#required-attribute).
* [BreakingAPIchangesinAntiforgery, CORS, Diagnostics, MVC, andRouting](https://github.com/aspnet/Announcements/issues/387). This list includes breaking changes for compatibility switches.
1237
-
*Forasummaryof2.2-to-3.0breakingchangesacross .NETCore, ASP.NETCore, andEntityFrameworkCore, see [Breakingchangesformigrationfromversion2.2to3.0](/dotnet/core/compatibility/2.2-3.0).
1237
+
*Forasummaryof2.2-to-3.0breakingchangesacross .NET, ASP.NETCore, andEntityFrameworkCore, see [Breakingchangesformigrationfromversion2.2to3.0](/dotnet/core/compatibility/2.2-3.0).
Copy file name to clipboardExpand all lines: aspnetcore/migration/30-to-31.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,9 +29,9 @@ This article explains how to update an existing ASP.NET Core 3.0 project to ASP.
29
29
30
30
---
31
31
32
-
## Update .NET Core SDK version in global.json
32
+
## Update .NET SDK version in global.json
33
33
34
-
If you rely upon a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET Core SDK version, update the `version` property to the 3.1 SDK version that's installed. For example:
34
+
If you rely upon a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET SDK version, update the `version` property to the 3.1 SDK version that's installed. For example:
35
35
36
36
```diff
37
37
{
@@ -97,7 +97,7 @@ In the `.pubxml` file update the `TargetFramework` to 3.1:
97
97
98
98
## Review breaking changes
99
99
100
-
Review 3.0-to-3.1 breaking changes across .NET Core, ASP.NET Core, and Entity Framework Core at [Breaking changes for migration from version 3.0 to 3.1](/dotnet/core/compatibility/3.0-3.1).
100
+
Review 3.0-to-3.1 breaking changes across .NET, ASP.NET Core, and Entity Framework Core at [Breaking changes for migration from version 3.0 to 3.1](/dotnet/core/compatibility/3.0-3.1).
Copy file name to clipboardExpand all lines: aspnetcore/migration/31-to-50.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,9 +28,9 @@ This article explains how to update an existing ASP.NET Core 3.1 project to ASP.
28
28
29
29
---
30
30
31
-
## Update .NET Core SDK version in global.json
31
+
## Update .NET SDK version in global.json
32
32
33
-
If you rely upon a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET Core SDK version, update the `version` property to the .NET 5 SDK version that's installed. For example:
33
+
If you rely upon a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET SDK version, update the `version` property to the .NET 5 SDK version that's installed. For example:
34
34
35
35
```diff
36
36
{
@@ -779,4 +779,4 @@ The following tutorials also explain the migration:
779
779
780
780
## Review breaking changes
781
781
782
-
For breaking changes from .NET Core 3.1 to .NET 5, see [Breaking changes for migration from version 3.1 to 5.0](/dotnet/core/compatibility/3.1-5.0). ASP.NET Core and Entity Framework Core are also included in the list.
782
+
For breaking changes from .NET 3.1 to .NET 5, see [Breaking changes for migration from version 3.1 to 5.0](/dotnet/core/compatibility/3.1-5.0). ASP.NET Core and Entity Framework Core are also included in the list.
Copy file name to clipboardExpand all lines: aspnetcore/migration/60-70.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,9 +26,9 @@ This article explains how to update an existing ASP.NET Core in .NET 6 project t
26
26
27
27
---
28
28
29
-
## Update .NET Core SDK version in global.json
29
+
## Update .NET SDK version in global.json
30
30
31
-
If you rely on a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET Core SDK version, update the `version` property to the .NET 7 SDK version that's installed. For example:
31
+
If you rely on a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET SDK version, update the `version` property to the .NET 7 SDK version that's installed. For example:
Copy file name to clipboardExpand all lines: aspnetcore/migration/70-80.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ This article explains how to update an existing ASP.NET Core in .NET 7 project t
24
24
25
25
## Update the .NET SDK version in `global.json`
26
26
27
-
If you rely on a [`global.json`](/dotnet/core/tools/global-json) file to target a specific .NET Core SDK version, update the `version` property to the .NET 8 SDK version that's installed. For example:
27
+
If you rely on a [`global.json`](/dotnet/core/tools/global-json) file to target a specific .NET SDK version, update the `version` property to the .NET 8 SDK version that's installed. For example:
Copy file name to clipboardExpand all lines: aspnetcore/migration/80-90.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,7 @@ This article explains how to update an ASP.NET Core in .NET 8 to ASP.NET Core in
27
27
28
28
## Update the .NET SDK version in `global.json`
29
29
30
-
If you rely on a [`global.json`](/dotnet/core/tools/global-json) file to target a specific .NET Core SDK version, update the `version` property to the .NET 9 SDK version that's installed. For example:
30
+
If you rely on a [`global.json`](/dotnet/core/tools/global-json) file to target a specific .NET SDK version, update the `version` property to the .NET 9 SDK version that's installed. For example:
0 commit comments