È possibile che si verifichino modifiche di rilievo durante la conversione del codice

Le modifiche che influiscono sulla compatibilità, altrimenti note come modifiche di rilievo, si verificheranno tra le versioni di .NET. Le modifiche sono importanti quando si esegue la conversione da .NET Framework a .NET a causa di determinate tecnologie non disponibili. Inoltre, è possibile trovare modifiche di rilievo semplicemente perché .NET è una tecnologia multipiattaforma e .NET Framework non è.

Microsoft si impegna a mantenere un elevato livello di compatibilità tra le versioni di .NET, quindi, mentre si verificano modifiche di rilievo, vengono considerate attentamente.

Prima di aggiornare le principali versioni, controllare la documentazione dei cambiamenti rilevanti per eventuali modifiche che potrebbero influire su di te.

Modifiche che influiscono sulla compatibilità

Esistono diversi tipi di modifiche che gli autori di librerie possono apportare che influiscono sulla compatibilità, tra cui:

• Modifiche al contratto pubblico
• Modifiche comportamentali
• Supporto delle piattaforme
• Modifiche all'implementazione interna
• Modifiche al codice

Per altre informazioni sul tipo di modifiche consentite o non consentite, vedere Modificare le regole per la compatibilità.

Tipi di compatibilità

La compatibilità si riferisce alla possibilità di compilare o eseguire codice in un'implementazione .NET diversa da quella con cui è stato originariamente sviluppato il codice.

Esistono sei modi diversi in cui una modifica può influire sulla compatibilità:

• Modifiche comportamentali
• Compatibilità binaria
• Compatibilità del codice sorgente
• Compatibilità in fase di progettazione
• Compatibilità retroattiva
• Compatibilità futura

Per altre informazioni, vedere Come le modifiche al codice possono influire sulla compatibilità.

Trovare modifiche che causano un'interruzione

Le modifiche che influiscono sulla compatibilità sono documentate. Esaminare queste modifiche prima di convertire il codice da .NET Framework a .NET o aggiornarlo a una versione più recente di .NET. Per un elenco di queste modifiche di rilievo, vedere Modifiche di rilievo per la migrazione da .NET Framework a .NET Core.