Des changements cassants peuvent se produire lors du portage du code

Les modifications qui affectent la compatibilité, également appelées changements cassants, se produisent entre les versions de .NET. Les modifications sont impactantes lors du portage de .NET Framework vers .NET en raison de certaines technologies qui ne sont pas disponibles. En outre, vous pouvez rencontrer des modifications majeures en raison du fait que .NET est une technologie multiplateforme et que le .NET Framework ne l'est pas.

Microsoft s'efforce de maintenir un niveau élevé de compatibilité entre les versions de .NET, donc bien que des changements incompatibles puissent survenir, ils sont soigneusement pris en compte.

Avant de mettre à niveau les principales versions, consultez la documentation sur les modifications importantes qui pourraient vous affecter.

Modifications qui affectent la compatibilité

Il existe plusieurs types de modifications que les auteurs de bibliothèques peuvent apporter qui affectent la compatibilité, notamment :

• Modifications apportées au contrat public
• Changements comportementaux
• Support de la plateforme
• Modifications de l’implémentation interne
• Modifications du code

Pour plus d’informations sur le type de modification autorisé ou interdit, consultez Les règles de modification pour la compatibilité.

Types de compatibilité

La compatibilité fait référence à la possibilité de compiler ou d’exécuter du code sur une implémentation .NET autre que celle avec laquelle le code a été développé à l’origine.

Il existe six façons différentes d’affecter la compatibilité :

• Changements comportementaux
• Compatibilité binaire
• Compatibilité de la source
• Compatibilité au moment du design
• Rétrocompatibilité
• Compatibilité vers l’avant

Pour plus d’informations, consultez Comment les modifications de code peuvent affecter la compatibilité.

Rechercher les changements cassants

Les modifications qui affectent la compatibilité sont documentées. Passez en revue ces modifications avant de porter votre code de .NET Framework vers .NET ou de le mettre à niveau vers une version plus récente de .NET. Pour obtenir la liste de ces modifications importantes, consultez Modifications importantes pour la migration de .NET Framework vers .NET Core.