Icke-bakåtkompatibla ändringar kan uppstå när man portar kod

Ändringar som påverkar kompatibiliteten, även kallade brytande ändringar, sker mellan versioner av .NET. Ändringar är betydande när du porterar från .NET Framework till .NET eftersom vissa tekniker inte är tillgängliga. Dessutom kan du stöta på icke-bakåtkompatibla ändringar bara för att .NET är en plattformsoberoende teknik och .NET Framework inte är det.

Microsoft strävar efter att upprätthålla en hög nivå av kompatibilitet mellan .NET-versioner, så även om förändringar som bryter kompatibilitet sker, beaktas de noggrant.

Innan du uppgraderar till större versioner, se över dokumentationen om icke-bakåtkompatibla ändringar som kan påverka dig.

Ändringar som påverkar kompatibiliteten

Det finns flera typer av ändringar som biblioteksförfattare kan göra som påverkar kompatibiliteten, inklusive:

• Ändringar i det offentliga kontraktet
• Förändringar i beteende
• Plattformsstöd
• Interna implementeringsändringar
• Kodändringar

Mer information om vilken typ av ändringar som tillåts eller inte tillåts finns i Ändra regler för kompatibilitet.

Typer av kompatibilitet

Kompatibilitet syftar på möjligheten att kompilera eller köra kod på en annan .NET-implementering än den som koden ursprungligen utvecklades med.

Det finns sex olika sätt som en ändring kan påverka kompatibiliteten på:

• Förändringar i beteende
• Binär kompatibilitet
• Källkompatibilitet
• Design-time-kompatibilitet
• Bakåtkompatibilitet
• Framåtkompatibilitet

Mer information finns i Hur kodändringar kan påverka kompatibiliteten.

Hitta brytande ändringar

Ändringar som påverkar kompatibiliteten dokumenteras. Granska dessa ändringar innan du porterar koden från .NET Framework till .NET eller uppgradera den till en nyare version av .NET. En lista över dessa icke-bakåtkompatibla ändringar finns i Icke-bakåtkompatibla ändringar för migrering från .NET Framework till .NET Core.