Brytande ändringar i .NET 10

Om du migrerar en applikation till .NET 10 kan de ändringar som inte är kompatibla med tidigare versioner, och som anges i listan 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 större ändringar i .NET 10.

ASP.NET Core

Se Icke-bakåtkompatibla ändringar i ASP.NET Core 10.

Containers

Titel Typ av ändring
Standard-.NET-avbildningar använder Ubuntu Beteendeförändring
dotnet-test behöver en skrivbar VSTest-artefaktbaskatalog i containrar Beteendeförändring

De grundläggande .NET-biblioteken

Titel Typ av ändring
API-utfasningar Källan är inkompatibel
Beteendeförändring för ActivitySource.CreateActivity och ActivitySource.StartActivity Beteendeförändring
Arm64 SVE icke-felgenererande laddningar kräver mask Binär/källinkompatibel
BufferedStream.WriteByte utför inte längre implicit tömning Beteendeförändring
C# 14 överlagringslösning med spanparametrar Beteendeförändring
Konsekvent skiftbeteende i generell matematik Beteendeförändring
Standardpropagator för spårningskontext uppdaterad till W3C-standard Beteendeförändring
DriveInfo.DriveFormat returnerar Linux-filsystemtyper Beteendeförändring
DynamicallyAccessedMembers-annoteringen har tagits bort från DefaultValueAttribute ctor Binär/källinkompatibel
Explicit struct Size tillåts inte med InlineArray Binärt inkompatibelt
FilePatternMatch.Stem har ändrats till icke-nullable Källinkompatibel/beteendeförändring
GnuTarEntry och PaxTarEntry innehåller inte längre atime och ctime som standard Beteendeförändring
LDAP DirectoryControl-parsning är nu strängare Beteendeförändring
Normalisering av MacCatalyst-version Beteendeförändring
Namngivna mutexes har användaromfång som standard i Unix Beteendeförändring
.NET runtime tillhandahåller inte längre standardtermineringssignalhanterare Beteendeförändring
System.Linq.AsyncEnumerable ingår i kärnbibliotek Källan är inkompatibel
Type.MakeGenericSignatureType validering av argument Beteendeförändring

Cryptography

Titel Typ av ändring
CompositeMLDsa har uppdaterats till draft-08 Beteendeförändring
CoseSigner.Key kan vara null Beteende-/källokompabilitetsändring
MLDsa- och SlhDsa-medlemmarna "SecretKey" har bytt namn Källan är inkompatibel
OpenSSL-kryptografiska primitiver stöds inte på macOS Beteendeförändring
OpenSSL 1.1.1 eller senare krävs på Unix Beteendeförändring
X500DistinguishedName-validering är striktare Beteendeförändring
X509Certificate- och PublicKey-nyckelparametrar kan vara null Beteende-/källokompabilitetsändring
Miljövariabeln har bytt namn till DOTNET_OPENSSL_VERSION_OVERRIDE Beteendeförändring

Entity Framework Core

Se ändringar i EF Core 10.

Extensions

Titel Typ av ändring
BackgroundService kör hela ExecuteAsync som en Task Beteendeförändring
Åtgärda problem i GetKeyedService() och GetKeyedServices() med AnyKey Beteendeförändring
Null-värden bevarade i konfigurationen Beteendeförändring
Meddelandet dupliceras inte längre i konsolloggens utdata Beteendeförändring
ProviderAliasAttribute har flyttats till sammansättningen Microsoft.Extensions.Logging.Abstractions Källan är inkompatibel
DynamicallyAccessedMembers-anteckningen har tagits bort från trim-osäkra Microsoft.Extensions.Configuration-kod Binärt inkompatibelt

Globalization

Titel Typ av ändring
Miljövariabeln har bytt namn till DOTNET_ICU_VERSION_OVERRIDE Beteendeförändring

Installationsverktyg

Titel Typ av ändring
dotnet.acquire API för VS Code hämtar inte längre alltid den senaste Beteendeförändring

Interop

Titel Typ av ändring
Det går inte att casta IDispatchEx COM-objekt till IReflect Beteendeförändring
Appar med en fil letar inte längre efter inbyggda bibliotek i den körbara katalogen Beteendeförändring
Om du anger DllImportSearchPath.AssemblyDirectory genomsöks endast sammansättningsmappen Beteendeförändring

Nätverkande

Titel Typ av ändring
HTTP/3-stöd har inaktiverats som standard med PublishTrimmed Källan är inkompatibel
MailAddress framtvingar validering för punkter i rad Beteendeförändring
Strömmande HTTP-svar aktiverade som standard i webbläsares HTTP-klienter Beteendeförändring
Uri längdgränser har tagits bort Beteendeförändring

Reflection

Titel Typ av ändring Lanserad version
Mer begränsade annoteringar för InvokeMember/FindMembers/DeclaredMembers Beteende-/källkompatibel
Argumentvalidering för Type.MakeGenericSignatureType Beteendeförändring

SDK och MSBuild

Titel Typ av ändring
.NET CLI --interactive har standardvärdet true i användarscenarier Beteendeförändring
dotnet CLI-kommandon loggar data som inte är relevanta för kommandot till stderr Beteendeförändring
Paketering av .NET-verktyg skapar RuntimeIdentifier-specifika verktygspaket Beteendeförändring
Standardkonfiguration för arbetsbelastning ändras från läget "lösa manifest" till läget "workload sets" Beteendeförändring
DefineConstants för målramverk som inte är tillgängliga vid utvärderingstillfället Beteendeförändring
Kodtäckning EnableDynamicNativeInstrumentation är som standard falskt Beteendeförändring
dnx-skripten kringgår global.json SDK-val Beteendeförändring
dnx.ps1 fil ingår inte längre i .NET SDK Källan är inkompatibel
Dubbla citattecken i filnivådirektiv tillåts inte Källan är inkompatibel
dotnet new sln har som standard SLNX-filformat Beteendeförändring
dotnet package list utför återställning Beteendeförändring
dotnet restore granskar transitiva paket Beteendeförändring
dotnet tool install --local skapar ett manifest som standard Beteendeförändring
dotnet watch loggar till stderr i stället för stdout Beteendeförändring
project.json stöds inte i dotnet restore Källan är inkompatibel
Stöd för SHA-1-fingeravtryck har fasats ut i dotnet nuget sign Beteendeförändring
MSBUILDCUSTOMBUILDEVENTWARNING escape hatch har tagits bort Beteendeförändring
MSBuild-resurshantering för anpassad kultur Beteendeförändring
NU1510 genereras för direktreferenser som rensas bort av NuGet Källan är inkompatibel
NuGet-paket utan runtime-resurser ingår inte i deps.json Källan är inkompatibel
PackageReference utan en version genererar ett fel Beteendeförändring
PrunePackageReference gör direkta beskärbara referenser privata Beteendeförändring
HTTP-varningar har befordrats till fel i dotnet package list och dotnet package search Beteende-/källokompabilitetsändring
NUGET_ENABLE_ENHANCED_HTTP_RETRY miljövariabeln har tagits bort Beteendeförändring
NuGet-granskningskällor tillåter inte längre osäker HTTP som standard Beteendeförändring
NuGet loggar ett fel för ogiltiga paket-ID:n Beteendeförändring
ToolCommandName inte inställt för paket som inte är verktyg Källan är inkompatibel
Installation av mallpaket verifierar NuGet-signaturer Beteendeförändring

Serialisering

Titel Typ av ändring
System.Text.Json kontrollerar egenskapsnamnskonflikter Beteendeförändring
XmlSerializer ignorerar inte längre egenskaper som markerats med ObsoleteAttribute Beteendeförändring

Windows Forms

Titel Typ av ändring
API-utfasningar Källan är inkompatibel
Program som refererar till både WPF och WinForms måste särskilja typerna MenuItem och ContextMenu Källan är inkompatibel
Parametern har bytt namn i HtmlElement.InsertAdjacentElement Källan är inkompatibel
TreeView-kryssrutebild trunkering Beteendeförändring
StatusStrip använder System RenderMode som standard Beteendeförändring
System.Drawing OutOfMemoryException har ändrats till ExternalException Beteendeförändring

Windows Presentation Foundation (WPF)

Titel Typ av ändring
Tomma ColumnDefinitions och RowDefinitions tillåts inte Källan är inkompatibel
Felaktig användning av DynamicResource orsakar programkrasch Källinkompatibel/beteendeförändring