Dela via

Microsoft.AspNetCore.All metapackage för ASP.NET Core 2.0

Anmärkning

Det här är inte den senaste versionen av den här artikeln. För den nuvarande utgåvan, se .NET 9-versionen av den här artikeln .

Varning

Den här versionen av ASP.NET Core stöds inte längre. Mer information finns i supportpolicyn för .NET och .NET Core. För den nuvarande utgåvan, se .NET 9-versionen av den här artikeln .

Viktigt!

Den här informationen gäller en förhandsversionsprodukt som kan ändras avsevärt innan den släpps kommersiellt. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, med avseende på den information som tillhandahålls här.

För den nuvarande utgåvan, se .NET 9-versionen av den här artikeln .

Anmärkning

Metapaketet Microsoft.AspNetCore.All används inte i ASP.NET Core 3.0 eller senare. Mer information finns i det här GitHub-problemet.

Anmärkning

Vi rekommenderar att program som riktar sig till ASP.NET Core 2.1 eller senare använder Microsoft.AspNetCore.App metapackage i stället för det här paketet. Se Migrera från Microsoft.AspNetCore.All till Microsoft.AspNetCore.App i den här artikeln.

Den här funktionen kräver ASP.NET Core 2.x som är riktad mot .NET Core 2.x.

Microsoft.AspNetCore.All är ett metapaket som refererar till ett delat ramverk. Ett delat ramverk är en uppsättning sammansättningar (.dll filer) som inte finns i appens mappar. Det delade ramverket måste vara installerat på datorn för att kunna köra appen. Mer information finns i Det delade ramverket.

Det delade ramverket som Microsoft.AspNetCore.All refererar till omfattar:

  • Alla paket som stöds av ASP.NET Core-teamet.
  • Alla paket som stöds av Entity Framework Core.
  • Interna och tredjepartsberoenden som används av ASP.NET Core och Entity Framework Core.

Alla funktioner i ASP.NET Core 2.x och Entity Framework Core 2.x ingår i Microsoft.AspNetCore.All paketet. Standardprojektmallarna för ASP.NET Core 2.0 använder det här paketet.

Versionsnumret för Microsoft.AspNetCore.All metapaketet representerar den lägsta ASP.NET Core-versionen och Entity Framework Core-versionen.

Följande .csproj fil refererar till Microsoft.AspNetCore.All metapaketet för 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>

Implicit versionskontroll

I ASP.NET Core 2.1 eller senare kan du ange paketreferensen Microsoft.AspNetCore.All utan en version. När versionen inte har angetts anges en implicit version av SDK (Microsoft.NET.Sdk.Web). Vi rekommenderar att du förlitar dig på den implicita version som anges av SDK och inte uttryckligen anger versionsnumret för paketreferensen. Om du har frågor om den här metoden lämnar du en GitHub-kommentar i Diskussion för den Microsoft.AspNetCore.App implicita versionen.

Den implicita versionen är inställd på major.minor.0 för bärbara appar. Roll-forward-mekanismen för delade plattformar kör appen på den senaste kompatibla versionen bland de installerade delade plattformarna. För att garantera att samma version används i utveckling, testning och produktion kontrollerar du att samma version av det delade ramverket är installerad i alla miljöer. För fristående appar anges det implicita versionsnumret till det major.minor.patch delade ramverket som paketeras i det installerade SDK:t.

Att ange ett versionsnummer för paketreferensen Microsoft.AspNetCore.All garanterar inte att den versionen av det delade ramverket väljs. Anta till exempel att version 2.1.1 har angetts, men att "2.1.3" är installerat. I så fall använder appen "2.1.3". Även om det inte rekommenderas kan du inaktivera uppgradering (patch och/eller mindre version). Mer information om roll-forward för dotnet-värd och hur du konfigurerar dess beteende finns i roll forward för dotnet-värd.

Projektets SDK måste anges till Microsoft.NET.Sdk.Web i projektfilen för att använda den implicita versionen av Microsoft.AspNetCore.All. Microsoft.NET.Sdk När SDK:n har angetts (<Project Sdk="Microsoft.NET.Sdk"> överst i projektfilen) genereras följande varning:

Varning NU1604: Projektberoende Microsoft.AspNetCore.All innehåller inte en inkluderande lägre bindning. Inkludera en lägre bindning i beroendeversionen för att säkerställa konsekventa återställningsresultat.

Det här är ett känt problem med .NET Core 2.1 SDK och kommer att åtgärdas i .NET Core 2.2 SDK.

Migrera från Microsoft.AspNetCore.All till Microsoft.AspNetCore.App

Följande paket ingår i Microsoft.AspNetCore.All men inte paketet Microsoft.AspNetCore.App .

  • Microsoft.AspNetCore.ApplicationInsights.HostingStartup
  • Microsoft.AspNetCore.AzureAppServices.HostingStartup
  • Microsoft.AspNetCore.AzureAppServicesIntegration
  • Microsoft.AspNetCore.DataProtection.AzureKeyVault
  • Microsoft.AspNetCore.DataProtection.AzureStorage
  • Microsoft.AspNetCore.Server.Kestrel.Transport.Libuv
  • Microsoft.AspNetCore.SignalR.Redis
  • Microsoft.Data.Sqlite
  • Microsoft.Data.Sqlite.Core
  • Microsoft.EntityFrameworkCore.Sqlite
  • Microsoft.EntityFrameworkCore.Sqlite.Core
  • Microsoft.Extensions.Caching.Redis
  • Microsoft.Extensions.Configuration.AzureKeyVault
  • Microsoft.Extensions.Logging.AzureAppServices
  • Microsoft.VisualStudio.Web.BrowserLink

Om du vill flytta från Microsoft.AspNetCore.All till Microsoft.AspNetCore.App, om din app använder api:er från ovanstående paket, eller paket som hämtas av dessa paket, lägger du till referenser till paketen i projektet.

Eventuella beroenden för de föregående paketen som annars inte är beroenden av Microsoft.AspNetCore.App inkluderas inte implicit. Till exempel:

  • StackExchange.Redis som ett beroende av Microsoft.Extensions.Caching.Redis
  • Microsoft.ApplicationInsights som ett beroende av Microsoft.AspNetCore.ApplicationInsights.HostingStartup

Uppdatera ASP.NET Core 2.1

Vi rekommenderar att du migrerar till Microsoft.AspNetCore.App metapaketet för 2.1 eller senare. Så här fortsätter du att använda Microsoft.AspNetCore.All metapackage och se till att den senaste korrigeringsversionen distribueras:

  • På utvecklingsdatorer och byggservrar: Installera den senaste .NET Core SDK.
  • På distributionsservrar: Installera den senaste .NET Core-körningen. Din app kommer att vidarebefordras till den senaste installerade versionen vid en omstart av programmet.