Alterações de tempo de execução para a migração do .NET Framework 4.5 para 4.5.1Runtime Changes for Migration from .NET Framework 4.5 to 4.5.1

Introduction

Runtime changes affect all apps that are running under a .NET Framework it was not compiled against and that use a particular feature.

In the topics that describe runtime changes, we have classified individual items by their expected impact, as follows:

Major This is a significant change that affects a large number of apps or that requires substantial modification of code.

Minor This is a change that affects a small number of apps or that requires minor modification of code.

Edge case This is a change that affects apps under very specific scenarios that are not common.

Transparent This is a change that has no noticeable effect on the app's developer or user. The app should not require modification because of this change.

Se você estiver migrando do .NET Framework 4.5 para 4.5.1, examine os seguintes tópicos sobre problemas de compatibilidade do aplicativo que podem afetar seu aplicativo:If you are migrating from the .NET Framework 4.5 to 4.5.1, review the following topics for application compatibility issues that may affect your app:

ADO.NETADO.NET

Agora, ADO.NET tentará reconectar automaticamente conexões SQL interrompidasADO.NET now attempts to automatically reconnect broken SQL connections

DetalhesDetails A partir do .NET Framework 4.5.1, o .NET Framework tentará reconectar automaticamente conexões SQL interrompidas.Beginning in the .NET Framework 4.5.1, the .NET Framework will attempt to automatically reconnect broken SQL connections. Embora, normalmente, isso torne os aplicativos mais confiáveis, há casos de borda em que um aplicativo precisa saber que a conexão foi perdida para tomar medidas sobre a reconexão.Although this will typically make apps more reliable, there are edge cases in which an app needs to know that the connection was lost so that it can take some action upon reconnection.
SugestãoSuggestion Se esse recurso for indesejável devido a preocupações de compatibilidade, ele poderá ser desabilitado por meio da configuração da propriedade ConnectRetryCount de uma cadeia de conexão (ou SqlConnectionStringBuilder) para 0.If this feature is undesirable due to compatibility concerns, it can be disabled by setting the ConnectRetryCount property of a connection string (or SqlConnectionStringBuilder) to 0.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.5.14.5.1
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

NúcleoCore

Um ConcurrentDictionary serializado no .NET Framework 4.5 com NetDataContractSerializer não pode ser desserializado pelo .NET Framework 4.5.1 ou 4.5.2A ConcurrentDictionary serialized in .NET Framework 4.5 with NetDataContractSerializer cannot be deserialized by .NET Framework 4.5.1 or 4.5.2

DetalhesDetails Devido a alterações internas no tipo, objetos ConcurrentDictionary<TKey,TValue> serializados com o .NET Framework 4.5 usando o NetDataContractSerializer não podem ser desserializados no .NET Framework 4.5.1 ou no .NET Framework 4.5.2. Observe que mover-se no outro sentido (serializar com o .NET Framework 4.5.x e desserializar com o .NET Framework 4.5) funciona.Due to internal changes to the type, ConcurrentDictionary<TKey,TValue> objects that are serialized with the .NET Framework 4.5 using the NetDataContractSerializer cannot be deserialized in the .NET Framework 4.5.1 or in the .NET Framework 4.5.2.Note that moving in the other direction (serializing with the .NET Framework 4.5.x and deserializing with the .NET Framework 4.5) works. Da mesma forma, todas as serializações entre versões 4. x funcionam com o .NET Framework 4.6. A possibilidade de serializar e desserializar com uma única versão do .NET Framework não é afetada.Similarly, all 4.x cross-version serialization works with the .NET Framework 4.6.Serializing and deserializing with a single version of the .NET Framework is not affected.
SugestãoSuggestion Se for necessário serializar e desserializar um ConcurrentDictionary<TKey,TValue> entre o .NET Framework 4.5 e o .NET Framework 4.5.1/4.5.2, um serializador alternativo como o serializador DataContractSerializer ou BinaryFormatter deve ser usado em vez do NetDataContractSerializer. Como alternativa, uma vez que esse problema é resolvido no .NET Framework 4.6, isso pode ser solucionado com a atualização para essa versão do .NET Framework.If it is necessary to serialize and deserialize a ConcurrentDictionary<TKey,TValue> between the .NET Framework 4.5 and .NET Framework 4.5.1/4.5.2, an alternate serializer like the DataContractSerializer or BinaryFormatter serializer should be used instead of the NetDataContractSerializer.Alternatively, because this issue is addressed in the .NET Framework 4.6, it may be solved by upgrading to that version of the .NET Framework.
EscopoScope SecundárioMinor
VersãoVersion 4.5.14.5.1
TipoType Tempo de execuçãoRuntime

ConcurrentQueue<T>.TryPeek pode retornar um nulo errado por meio de seus parâmetros de saídaConcurrentQueue<T>.TryPeek can return an erroneous null via its out parameter

DetalhesDetails Em alguns cenários multithread, TryPeek(T) pode retornar true, mas popular o parâmetro de saída com um valor nulo (em vez do valor correto, inspecionado).In some multi-threaded scenarios, TryPeek(T) can return true, but populate the out parameter with a null value (instead of the correct, peeked value).
SugestãoSuggestion Esse problema foi corrigido no .NET Framework 4.5.1.This issue is fixed in the .NET Framework 4.5.1. O upgrade para esse Framework resolverá o problema.Upgrading to that Framework will solve the issue.
EscopoScope PrincipalMajor
VersãoVersion 4.54.5
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

COR_PRF_GC_ROOT_HANDLEs não estão sendo enumerados por criadores de perfilCOR_PRF_GC_ROOT_HANDLEs are not being enumerated by profilers

DetalhesDetails No .NET Framework v4.5.1, a API de criação de perfil RootReferences2(), de maneira incorreta, nunca retorna COR_PRF_GC_ROOT_HANDLE (que, em vez disso, é retornada como COR_PRF_GC_ROOT_OTHER).In the .NET Framework v4.5.1, the profiling API RootReferences2() is incorrectly never returning COR_PRF_GC_ROOT_HANDLE (they are returned as COR_PRF_GC_ROOT_OTHER instead). Esse problema foi corrigido a partir do .NET Framework 4.6.This issue is fixed beginning in the .NET Framework 4.6.
SugestãoSuggestion Esse problema foi corrigido no .NET Framework 4.6 e pode ser resolvido com o upgrade para essa versão do .NET Framework.This issue has been fixed in the .NET Framework 4.6 and may be addressed by upgrading to that version of the .NET Framework.
EscopoScope SecundárioMinor
VersãoVersion 4.5.14.5.1
TipoType Tempo de execuçãoRuntime

Desserialização de objetos em domínios de aplicativo podem falharDeserialization of objects across appdomains can fail

DetalhesDetails Em alguns casos, quando um aplicativo usa dois ou mais domínios de aplicativo com bases de aplicativo diferentes, a tentativa de desserializar objetos no contexto da chamada lógica nos domínios de aplicativo aciona uma exceção.In some cases, when an app uses two or more app domains with different application bases, trying to deserialize objects in the logical call context across app domains throws an exception.
SugestãoSuggestion Confira Mitigação: Desserialização de objetos em domínios do aplicativoSee Mitigation: Deserialization of Objects Across App Domains
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.5.14.5.1
TipoType Tempo de execuçãoRuntime

EventListener trunca cadeias de caracteres com nulos inseridosEventListener truncates strings with embedded nulls

DetalhesDetails EventListener trunca cadeias de caracteres com nulos inseridos.EventListener truncates strings with embedded nulls. Os caracteres nulos não são compatíveis com a classe EventSource.Null characters are not supported by the EventSource class. A alteração afeta apenas os aplicativos que usam EventListener para ler dados EventSource no processo e que usam caracteres nulos como delimitadores.The change only affects apps that use EventListener to read EventSource data in process and that use null characters as delimiters.
SugestãoSuggestion Os dados EventSource devem ser atualizados, se possível, para não usar caracteres nulos inseridos.EventSource data should be updated, if possible, to not use embedded null characters.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.5.14.5.1
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

EventSource.WriteEvent deve passar a WriteEvent os mesmos parâmetros que recebeu (mais ID)EventSource.WriteEvent impls must pass WriteEvent the same parameters that it received (plus ID)

DetalhesDetails O tempo de execução agora aplica o contrato que especifica o seguinte: Uma classe derivada de EventSource que define um método de evento ETW deve chamar o método de classe base EventSource.WriteEvent com a ID do evento seguido dos mesmos argumentos que o método de evento ETW passou.The runtime now enforces the contract that specifies the following: A class derived from EventSource that defines an ETW event method must call the base class EventSource.WriteEvent method with the event ID followed by the same arguments that the ETW event method was passed.
SugestãoSuggestion Uma exceção IndexOutOfRangeException será acionada se um EventListener ler dados EventSource no processo de uma origem de evento que viola esse contrato.An IndexOutOfRangeException exception is thrown if an EventListener reads EventSource data in process for an event source that violates this contract.
EscopoScope SecundárioMinor
VersãoVersion 4.5.14.5.1
TipoType Tempo de execuçãoRuntime

As sobrecargas Marshal.SizeOf e Marshal.PtrToStructure interrompem o código dinâmicoMarshal.SizeOf and Marshal.PtrToStructure overloads break dynamic code

DetalhesDetails A partir do .NET Framework 4.5.1, a associação dinâmica aos métodos SizeOf<T>(), SizeOf<T>(T), PtrToStructure(IntPtr, Object), PtrToStructure(IntPtr, Type), PtrToStructure<T>(IntPtr) ou PtrToStructure<T>(IntPtr, T) (por meio do Windows PowerShell, IronPython ou da palavra-chave dinâmica do C#, por exemplo) pode resultar em MethodInvocationExceptions, pois novas sobrecargas desses métodos que foram adicionadas podem ser ambíguas para os mecanismos de script.Beginning in the .NET Framework 4.5.1, dynamically binding to the methods SizeOf<T>(), SizeOf<T>(T), PtrToStructure(IntPtr, Object), PtrToStructure(IntPtr, Type), PtrToStructure<T>(IntPtr), or PtrToStructure<T>(IntPtr, T), (via Windows PowerShell, IronPython, or the C# dynamic keyword, for example) can result in MethodInvocationExceptions because new overloads of these methods have been added that may be ambiguous to the scripting engines.
SugestãoSuggestion Atualize os scripts para indicar claramente qual sobrecarga deve ser usada.Update scripts to clearly indicate which overload should be used. Normalmente, isso pode ser feito convertendo explicitamente os parâmetros de tipo dos métodos como Type.This can typically done by explicitly casting the methods' type parameters as Type. Clique neste link para obter mais detalhes e exemplos de como contornar o problema.See this link for more detail and examples of how to workaround the issue.
EscopoScope SecundárioMinor
VersãoVersion 4.5.14.5.1
TipoType Tempo de execuçãoRuntime

Algumas APIs .NET causam EntryPointNotFoundExceptions de primeira chanceSome .NET APIs cause first chance (handled) EntryPointNotFoundExceptions

DetalhesDetails No .NET Framework 4.5, um pequeno número de métodos .NET começou a gerar EntryPointNotFoundExceptions de primeira chance.In the .NET Framework 4.5, a small number of .NET methods began throwing first chance EntryPointNotFoundExceptions. Essas exceções eram tratadas dentro do .NET Framework, mas podiam interromper a automação de teste que não esperava as exceções de primeira instância.These exceptions were handled within the .NET Framework, but could break test automation that did not expect the first chance exceptions. Essas mesmas APIs interrompem alguns cenários ApiVerifier quando HighVersionLie é habilitado.These same APIs break some ApiVerifier scenarios when HighVersionLie is enabled.
SugestãoSuggestion Esse bug pode ser evitado com a o upgrade para o .NET Framework 4.5.1.This bug can be avoided by upgrading to .NET Framework 4.5.1. Como alternativa, a automação de teste pode ser atualizada para não interromper EntryPointNotFoundException de primeira chance.Alternatively, test automation can be updated to not break on first-chance EntryPointNotFoundExceptions.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.54.5
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Adaptadores de fluxo do WinRT não chamam mais FlushAsync automaticamente ao fecharWinRT stream adapters no long call FlushAsync automatically on close

DetalhesDetails Em aplicativos da Windows Store, os adaptadores de fluxo do Windows Runtime não chamam mais o método de FlushAsync do método Dispose.In Windows Store apps, Windows Runtime stream adapters no longer call the FlushAsync method from the Dispose method.
SugestãoSuggestion Essa alteração deve ser transparente.This change should be transparent. Os desenvolvedores podem restaurar o comportamento anterior gravando um código como este:Developers can restore the previous behavior by writing code like this:
using (var stream = GetWindowsRuntimeStream() as Stream)
{
// do something
await stream.FlushAsync();
}
EscopoScope TransparenteTransparent
VersãoVersion 4.5.14.5.1
TipoType Tempo de execuçãoRuntime

DadosData

Agora, ADO.NET tentará reconectar automaticamente conexões SQL interrompidasADO.NET now attempts to automatically reconnect broken SQL connections

DetalhesDetails A partir do .NET Framework 4.5.1, o .NET Framework tentará reconectar automaticamente conexões SQL interrompidas.Beginning in the .NET Framework 4.5.1, the .NET Framework will attempt to automatically reconnect broken SQL connections. Embora, normalmente, isso torne os aplicativos mais confiáveis, há casos de borda em que um aplicativo precisa saber que a conexão foi perdida para tomar medidas sobre a reconexão.Although this will typically make apps more reliable, there are edge cases in which an app needs to know that the connection was lost so that it can take some action upon reconnection.
SugestãoSuggestion Se esse recurso for indesejável devido a preocupações de compatibilidade, ele poderá ser desabilitado por meio da configuração da propriedade ConnectRetryCount de uma cadeia de conexão (ou SqlConnectionStringBuilder) para 0.If this feature is undesirable due to compatibility concerns, it can be disabled by setting the ConnectRetryCount property of a connection string (or SqlConnectionStringBuilder) to 0.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.5.14.5.1
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

SerializaçãoSerialization

NetDataContractSerializer falha ao desserializar um ConcurrentDictionary serializado com uma versão diferente do .NETNetDataContractSerializer fails to deserialize a ConcurrentDictionary serialized with a different .NET version

DetalhesDetails Por design, o NetDataContractSerializer poderá ser usado somente se as extremidades de serialização e desserialização compartilharem os mesmos tipos CLR.By design, the NetDataContractSerializer can be used only if both the serializing and deserializing ends share the same CLR types. Portanto, não há garantia de que um objeto serializado com uma versão do .NET Framework poderá ser desserializado com uma versão diferente.ConcurrentDictionary<TKey,TValue>Therefore, it is not guaranteed that an object serialized with one version of the .NET Framework can be deserialized by a different version.ConcurrentDictionary<TKey,TValue> é um tipo que não será desserializado corretamente se for serializado com o .NET Framework 4.5 ou anterior e for desserializado com o .NET Framework 4.5.1 ou posterior.is a type that is known to not to deserialize correctly if serialized with the .NET Framework 4.5 or earlier and deserialized with the .NET Framework 4.5.1 or later.
SugestãoSuggestion Há uma série de possíveis soluções alternativas para esse problema:There are a number of possible work-arounds for this issue:
EscopoScope SecundárioMinor
VersãoVersion 4.5.14.5.1
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Windows Communication Foundation (WCF)Windows Communication Foundation (WCF)

MinFreeMemoryPercentageToActiveService agora é respeitadoMinFreeMemoryPercentageToActiveService is now respected

DetalhesDetails Essa configuração estabelece a memória mínima que deve estar disponível no servidor para que um serviço WCF possa ser ativado.This setting establishes the minimum memory that must be available on the server before a WCF service can be activated. Ela foi projetada para evitar exceções OutOfMemoryException.It is designed to prevent OutOfMemoryException exceptions. No .NET Framework 4.5, essa configuração não tinha nenhum efeito.In the .NET Framework 4.5, this setting had no effect. No .NET Framework 4.5.1, essa configuração é observada.In the .NET Framework 4.5.1, the setting is observed.
SugestãoSuggestion Ocorrerá uma exceção se a memória livre disponível no servidor Web for menor que a porcentagem definida pela definição de configuração.An exception occurs if the free memory available on the web server is less than the percentage defined by the configuration setting. Alguns serviços WCF iniciados com êxito e executados em um ambiente de memória restrito agora podem falhar.Some WCF services that successfully started and ran in a constrained memory environment may now fail.
EscopoScope SecundárioMinor
VersãoVersion 4.5.14.5.1
TipoType Tempo de execuçãoRuntime

Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)

Rolar em uma TreeView ou ListBox agrupada no WPF em um VirtualizingStackPanel pode fazer com que um aplicativo pare de responderScrolling a WPF TreeView or grouped ListBox in a VirtualizingStackPanel can result in an unresponsive application

DetalhesDetails No .NET Framework 4.5, rolar em uma TreeView do WPF em um painel de pilha virtualizado poderá fazer com que um aplicativo pare de responder se houver margens no visor (entre os itens na TreeView, por exemplo, ou em um elemento ItemsPresenter).In .NET Framework 4.5, scrolling a WPF TreeView in a virtualized stack panel can cause an application to become unresponsive if there are margins in the viewport (between the items in the TreeView, for example, or on an ItemsPresenter element). Além disso, em alguns casos, itens de tamanhos diferentes no modo de exibição podem causar instabilidade, mesmo se não houver margens.Additionally, in some cases, different sized items in the view can cause instability even if there are no margins.
SugestãoSuggestion Esse bug pode ser evitado com a o upgrade para o .NET Framework 4.5.1.This bug can be avoided by upgrading to .NET Framework 4.5.1. Como alternativa, as margens poderão ser removidas das coleções de exibições (como TreeViews) em painéis de pilha virtualizados se todos os itens contidos forem do mesmo tamanho.Alternatively, margins can be removed from view collections (like TreeViews) within virtualized stack panels if all contained items are the same size.
EscopoScope PrincipalMajor
VersãoVersion 4.54.5
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs