Breaking Changes können beim Portieren von Code auftreten.

Änderungen, die sich auf die Kompatibilität auswirken, andernfalls als bruchbrechende Änderungen bezeichnet, treten zwischen .NET-Versionen auf. Änderungen haben beim Portieren von .NET Framework zu .NET erhebliche Auswirkungen, da bestimmte Technologien nicht verfügbar sind. Darüber hinaus können Sie einfach mit Breaking Changes konfrontiert werden, weil .NET eine plattformübergreifende Technologie ist und .NET Framework nicht.

Microsoft ist bestrebt, ein hohes Maß an Kompatibilität zwischen .NET-Versionen aufrechtzuerhalten, und achtet sorgfältig auf potenziell auftretende Breaking Changes.

Bevor Sie Hauptversionen aktualisieren, überprüfen Sie die Dokumentation zu wichtigen Änderungen auf Änderungen, die sich möglicherweise auf Sie auswirken.

Änderungen, die sich auf kompatibilität auswirken

Es gibt mehrere Arten von Änderungen, die Bibliotheksautoren vornehmen können, die sich auf die Kompatibilität auswirken können, einschließlich:

• Änderungen am öffentlichen Vertrag
• Verhaltensänderungen
• Plattformunterstützung
• Interne Implementierungsänderungen
• Codeänderungen

Weitere Informationen dazu, welche Arten von Änderungen zulässig oder unzulässig sind, finden Sie unter Ändern von Regeln zur Kompatibilität.

Kompatibilitätstypen

Kompatibilität bezieht sich auf die Möglichkeit zum Kompilieren oder Ausführen von Code in einer anderen .NET-Implementierung als der, mit der der Code ursprünglich entwickelt wurde.

Es gibt sechs verschiedene Möglichkeiten, wie sich eine Änderung auf die Kompatibilität auswirken kann:

• Verhaltensänderungen
• Binärkompatibilität
• Quellkompatibilität
• Entwurfszeitkompatibilität
• Abwärtskompatibilität
• Vorwärtskompatibilität

Weitere Informationen finden Sie unter Wie Codeänderungen die Kompatibilität beeinflussen können.

Suchen von Breaking Changes

Änderungen, die sich auf die Kompatibilität auswirken, werden dokumentiert. Überprüfen Sie diese Änderungen, bevor Sie Ihren Code von .NET Framework zu .NET portieren oder auf eine neuere Version von .NET aktualisieren. Eine Liste dieser grundlegenden Änderungen finden Sie unter "Grundlegende Änderungen für die Migration von .NET Framework zu .NET Core".