Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Om du migrerar en app till .NET 11 kan de icke-bakåtkompatibla ändringarna som anges här påverka dig. Ändringar grupperas efter teknikområde, till exempel ASP.NET Core eller Windows Forms.
Den här artikeln kategoriserar varje ändring som binärt inkompatibel eller källinkompatibel, eller som en beteendeförändring:
Binärt inkompatibelt – När det körs mot den nya körningen eller komponenten kan befintliga binärfiler stöta på en icke-bakåtkompatibel beteendeförändring, till exempel att det inte går att läsa in eller köra, och i så fall kräva omkompilering.
Inkompatibel källa – När den omkompileras med den nya SDK:n eller komponenten eller för att rikta in sig på den nya körningen kan befintlig källkod kräva källändringar för att kompileras korrekt.
Beteendeförändring – Befintlig kod och binärfiler kan bete sig annorlunda vid körning. Om det nya beteendet är oönskat måste befintlig kod uppdateras och kompileras om.
Anmärkning
Den här artikeln är ett pågående arbete. Det är inte en fullständig lista över breaking changes i .NET 11.
ASP.NET Core
Se Breaking changes in ASP.NET Core 11.
Containers
| Titel | Typ av ändring |
|---|---|
| dotnet test behöver en skrivbar VSTest-artefaktbaskatalog i containrar | Beteendeförändring |
Core .NET-bibliotek
Cryptography
| Titel | Typ av ändring |
|---|---|
| API-utfasningar | Källan är inkompatibel |
| Sammansatt ML-DSA på Windows använder inbyggd implementering | Beteendeförändring |
| DSA har tagits bort från macOS | Beteendeförändring |
| HKDF på Windows använder CNG-implementering | Beteendeförändring |
| Hämtning av Linux AIA-certifikat begränsad till två hämtningar per kedjebyggnad | Beteendeförändring |
Driftsättning
| Titel | Typ av ändring |
|---|---|
| konfigurationEgenskaper i .runtimeconfig.dev.json åsidosätter .runtimeconfig.json | Beteendeförändring |
Extensions
| Titel | Typ av ändring |
|---|---|
| ChangeToken.OnChange asynkrona överlagringar ombinder befintliga återanrop som returnerar Task | Beteendeförändring |
| Undantag för disponering av beroendeinjektionsomfång aggregerar undantag | Beteendeförändring |
| Tomma strängar i länkad konfiguration åsidosätter tidigare providers | Beteendeförändring |
| FileConfigurationProvider utlöser inte någon omladdningstoken efter ignorerat inläsningsfel | Beteendeförändring |
| FileConfigurationSource.OnLoadException-återanrop anropas för I/O-fel | Beteendeförändring |
| IHost.RunAsync och IHost.StopAsync utlöser ett undantag när en BackgroundService misslyckas | Beteendeförändring |
| Generatorn för alternativvalidering rapporterar SYSLIB1205 för explicita valideringsimplementeringar | Källan är inkompatibel |
| PhysicalFilesWatcher validerar roten och FileSystemWatcher-sökvägar | Beteendeförändring |
| Några Microsoft.Extensions-paket som ingår i ett delat ramverk | Beteendeförändring |
Globalization
| Titel | Typ av ändring |
|---|---|
| Lägsta datum för japansk kalender som stöds har korrigerats | Beteendeförändring |
Interop
| Titel | Typ av ändring |
|---|---|
| Native AOT avvisar icke-blittable UnmanagedCallersOnly-signaturer | Beteendeförändring |
| NativeAOT använder lib-prefix för utdata för interna bibliotek i Unix | Beteendeförändring |
JIT-kompilator
| Titel | Typ av ändring |
|---|---|
| Flyttalskonverteringar till små integraltyper är saturerande | Beteendeförändring |
| Lägsta maskinvarukrav har uppdaterats | Beteendeförändring |
Networking
| Titel | Typ av ändring |
|---|---|
| HttpClient-mått med hög kardinalitet använder observerbara räknare | Beteendeförändring |
| SslStream-AIA-certifikatnedladdningar på serversidan är inaktiverade som standard | Beteendeförändring |
.NET MAUI
| Titel | Typ av ändring |
|---|---|
| Android x86 stöds inte | Binär inkompatibel och beteendemässig förändring |
| Kodgenerering på mobiler ändras från Mono till CoreCLR | Källinkompatibel/beteendeförändring |
| CoreCLR ersätter Mono runtime för .NET mobilappar | Binär/källinkompatibel/beteendeförändring |
| CoreCLR-spårningshändelser ersätter Mono-spårningshändelser | Binär/källinkompatibel/beteendeförändring |
| Ändringar i kraschrapporteringsbeteendet på mobila plattformar | Beteendeförändring |
Felsökningsgränssnitt på mobila plattformar ändras till ICorDebug |
Binär/källinkompatibel/beteendeförändring |
| Lägsta Android API-nivå höjdes till 24 | Beteendeförändring |
| Mono-inbäddnings-API:er stöds inte längre på mobila plattformar | Binär/källinkompatibel/beteendeförändring |
| Egenskaper för monoprojekt konfigurerar inte längre mobilappar | Källinkompatibel/beteendeförändring |
| Inställningar för Mono runtime konfigurerar inte längre mobilappar | Beteende-/källkompatibel |
| UnwindNativeCode stöds inte på Apple-mål | Källinkompatibel/beteendeförändring |
SDK och MSBuild
| Titel | Typ av ändring |
|---|---|
| dnx-skripten kringgår global.json SDK-val | Beteendeförändring |
| Fullständigt bygge utelämnades för Native AOT-publicering | Beteendeförändring |
| mono-startmål har inte angetts för .NET Framework-appar | Beteendeförändring |
| NativeAOT CLI-kommandohantering aktiverad som standard | Beteendeförändring |
| NU1703 varnar för paket som använder inaktuella MonoAndroid-ramverkstillgångar | Källan är inkompatibel |
| NuGet-låskatalogen har flyttats på Linux | Beteendeförändring |
| NuGet pack varnar för paket-ID:n med begränsade tecken | Beteendeförändring |
| Återställ söker inte i mappen globala paket efter högre version | Källan är inkompatibel |
| Val av lokal containerkörning för SDK:n använder helst plattformsanpassade verktyg | Beteendeförändring |
| Mallmotorpaket stöder inte längre netstandard2.0 | Binär/källinkompatibel |
| Installation av mallpaket verifierar NuGet-signaturer | Beteendeförändring |
| VSTest tar bort beroendet av Newtonsoft.Json | Binär/källinkompatibel |