Alterações interruptivas poderão ocorrer ao portar o código

As alterações que afetam a compatibilidade, também conhecidas como alterações interruptivas, ocorrerão entre as versões do .NET. As alterações são impactantes ao portar do .NET Framework para o .NET devido a determinadas tecnologias não estarem disponíveis. Além disso, você pode encontrar alterações significativas simplesmente porque o .NET é uma tecnologia multiplataforma e o .NET Framework não é.

A Microsoft se esforça para manter um alto nível de compatibilidade entre as versões do .NET, portanto, embora ocorram alterações significativas, elas são cuidadosamente consideradas.

Antes de atualizar as versões principais, verifique a documentação das alterações interruptivas para verificar as alterações que poderão afetar a compatibilidade.

Alterações que afetam a compatibilidade

Há vários tipos de alterações que os autores da biblioteca podem fazer que afetam a compatibilidade, incluindo:

• Modificações no contrato público
• Alterações comportamentais
• Suporte da plataforma
• Alterações de implementação internas
• Alterações de código

Para obter mais informações sobre que tipo de alterações são permitidas ou não permitidas, consulte Regras de alteração para compatibilidade.

Tipos de compatibilidade

Compatibilidade refere-se à capacidade de compilar ou executar código em uma implementação do .NET diferente daquela com a qual o código foi originalmente desenvolvido.

Há seis maneiras diferentes de uma alteração afetar a compatibilidade:

• Alterações comportamentais
• Compatibilidade binária
• Compatibilidade de origem
• Compatibilidade em tempo de desenvolvimento
• Compatibilidade retroativa
• Compatibilidade com futuras versões

Para obter mais informações, consulte Como as alterações de código podem afetar a compatibilidade.

Localizar as alterações interruptivas

As alterações que afetam a compatibilidade estão documentadas. Examine essas alterações antes de portar seu código do .NET Framework para o .NET ou atualize-o para uma versão mais recente do .NET. Para obter uma lista dessas alterações interruptivas, consulte Alterações interruptivas para migração do .NET Framework para o .NET Core.