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 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
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
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
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 |