Microsoft.AspNetCore.All metapackage for ASP.NET Core 2.0
We recommend applications targeting ASP.NET Core 2.1 and later use the Microsoft.AspNetCore.App metapackage rather than this package. See Migrating from Microsoft.AspNetCore.All to Microsoft.AspNetCore.App in this article.
This feature requires ASP.NET Core 2.x targeting .NET Core 2.x.
Microsoft.AspNetCore.All is a metapackage that refers to a shared framework. A shared framework is a set of assemblies (.dll files) that are not in the app's folders. The shared framework must be installed on the machine to run the app. For more information, see The shared framework.
The shared framework that
Microsoft.AspNetCore.All refers to includes:
- All supported packages by the ASP.NET Core team.
- All supported packages by the Entity Framework Core.
- Internal and 3rd-party dependencies used by ASP.NET Core and Entity Framework Core.
All the features of ASP.NET Core 2.x and Entity Framework Core 2.x are included in the
Microsoft.AspNetCore.All package. The default project templates targeting ASP.NET Core 2.0 use this package.
The version number of the
Microsoft.AspNetCore.All metapackage represents the minimum ASP.NET Core version and Entity Framework Core version.
The following .csproj file references the
Microsoft.AspNetCore.All metapackage for ASP.NET Core:
<Project Sdk="Microsoft.NET.Sdk.Web"> <PropertyGroup> <TargetFramework>netcoreapp2.0</TargetFramework> </PropertyGroup> <ItemGroup> <PackageReference Include="Microsoft.AspNetCore.All" Version="2.0.9" /> </ItemGroup> </Project>
In ASP.NET Core 2.1 or later, you can specify the
Microsoft.AspNetCore.All package reference without a version. When the version isn't specified, an implicit version is specified by the SDK (
Microsoft.NET.Sdk.Web). We recommend relying on the implicit version specified by the SDK and not explicitly setting the version number on the package reference. If you have questions about this approach, leave a GitHub comment at the Discussion for the Microsoft.AspNetCore.App implicit version.
The implicit version is set to
major.minor.0 for portable apps. The shared framework roll-forward mechanism runs the app on the latest compatible version among the installed shared frameworks. To guarantee the same version is used in development, test, and production, ensure the same version of the shared framework is installed in all environments. For self-contained apps, the implicit version number is set to the
major.minor.patch of the shared framework bundled in the installed SDK.
Specifying a version number on the
Microsoft.AspNetCore.All package reference does not guarantee that version of the shared framework is chosen. For example, suppose version "2.1.1" is specified, but "2.1.3" is installed. In that case, the app will use "2.1.3". Although not recommended, you can disable roll forward (patch and/or minor). For more information regarding dotnet host roll-forward and how to configure its behavior, see dotnet host roll forward.
The project's SDK must be set to
Microsoft.NET.Sdk.Web in the project file to use the implicit version of
Microsoft.AspNetCore.All. When the
Microsoft.NET.Sdk SDK is specified (
<Project Sdk="Microsoft.NET.Sdk"> at the top of the project file), the following warning is generated:
Warning NU1604: Project dependency Microsoft.AspNetCore.All does not contain an inclusive lower bound. Include a lower bound in the dependency version to ensure consistent restore results.
This is a known issue with the .NET Core 2.1 SDK and will be fixed in the .NET Core 2.2 SDK.
Migrating from Microsoft.AspNetCore.All to Microsoft.AspNetCore.App
The following packages are included in
Microsoft.AspNetCore.All but not the
To move from
Microsoft.AspNetCore.App, if your app uses any APIs from the above packages, or packages brought in by those packages, add references to those packages in your project.
Any dependencies of the preceding packages that otherwise aren't dependencies of
Microsoft.AspNetCore.App are not included implicitly. For example:
StackExchange.Redisas a dependency of
Microsoft.ApplicationInsightsas a dependency of
Update ASP.NET Core 2.1
We recommend migrating to the
Microsoft.AspNetCore.App metapackage for 2.1 and later. To keep using the
Microsoft.AspNetCore.All metapackage and ensure the latest patch version is deployed: