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

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

ASP.NETASP.NET

ASP.NET Corrigir a manipulação de InputAttributes e LabelAttributes para controle CheckBox de WebFormsASP.NET Fix handling of InputAttributes and LabelAttributes for WebForms CheckBox control

DetalhesDetails Para aplicativos que direcionam o .NET Framework 4.7.2 e versões anteriores, CheckBox.InputAttributes e CheckBox.LabelAttributes programaticamente adicionados a um controle CheckBox de WebForms são perdidos após o postback.For applications that target .NET Framework 4.7.2 and earlier versions, CheckBox.InputAttributes and CheckBox.LabelAttributes that are programmatically added to a WebForms CheckBox control are lost after postback. Para aplicativos que direcionam o .NET Framework 4.8 ou versões posteriores, eles são preservados após o postback.For applications that target .NET Framework 4.8 or later versions, they are preserved after postback.
SugestãoSuggestion Para o comportamento correto para restaurar atributos em postback, defina targetFrameworkVersion como 4.8 ou superior.For the correct behavior for restoring attributes on postback, set the targetFrameworkVersion to 4.8 or higher. Por exemplo:For example:
<configuration>
<system.web>
<httpRuntime targetFramework="4.8"/>
</system.web>
</configuration>
Defini-la como mais baixa ou não definir preserva o comportamento antigo incorreto.Setting it lower, or not at all, preserves the old incorrect behavior.
EscopoScope UnknownUnknown
VersãoVersion 4.84.8
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

ASP.NET A manipulação incorreta com várias partes pode resultar na perda dos dados de formulário.ASP.NET Incorrect multipart handling may result in lost form data.

DetalhesDetails Nos aplicativos que direcionam o .NET Framework 4.7.2 e versões anteriores, o ASP.Net pode analisar incorretamente valores de limite com várias partes, resultando na indisponibilidade dos dados de formulário durante a execução da solicitação.In applications that target .NET Framework 4.7.2 and earlier versions, ASP.Net might incorrectly parse multipart boundary values, resulting in form data being unavailable during request execution. Os aplicativos que direcionam o .NET Framework 4.8 ou versões posteriores analisam corretamente os dados com várias partes para que os valores de formulário estejam disponíveis durante a execução da solicitação.Applications that target .NET Framework 4.8 or later versions correctly parse multipart data, so form values are available during request execution.
SugestãoSuggestion Começando com aplicativos em execução no .NET Framework 4.8, ao direcionar o .NET Framework 4.8 ou posterior usando o elemento targetFrameworkVersion, o comportamento padrão é alterado para retirar os delimitadores.Starting with applications running on .NET Framework 4.8, when targeting .NET Framework 4.8 or later by using the targetFrameworkVersion element, the default behavior changes to strip delimiters. Ao direcionar versões anteriores da estrutura ou não usar targetFrameworkVersion, ainda são retornados delimitadores à direita para alguns valores. Esse comportamento também pode ser explicitamente controlado com um appSetting:When targeting previous framework versions or not using targetFrameworkVersion, trailing delimiters for some values are still returned.This behavior can also be explicitly controlled with an appSetting:
<configuration>
<appSettings>
...
<add key="aspnet:UseLegacyMultiValueHeaderHandling"  value="true"/>
...
</appSettings>
</configuration>
EscopoScope UnknownUnknown
VersãoVersion 4.84.8
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

ASP.NET ValidationContext.MemberName não é NULL ao usar o DataAnnotations.ValidationAttribute personalizadoASP.NET ValidationContext.MemberName is not NULL when using custom DataAnnotations.ValidationAttribute

DetalhesDetails No .NET Framework 4.7.2 e versões anteriores, ao usar um System.ComponentModel.DataAnnotations.ValidationAttribute personalizado, a propriedade ValidationContext.MemberName retorna null.In .NET Framework 4.7.2 and earlier versions, when using a custom System.ComponentModel.DataAnnotations.ValidationAttribute, the ValidationContext.MemberName property returns null. No .NET Framework 4.8, ela retorna o nome do membro.In .NET Framework 4.8, it returns the member name.
SugestãoSuggestion Para restaurar o comportamento anterior, adicione a seguinte configuração ao seu arquivo de configuração do aplicativo:To restore the previous behavior, add the following setting to your app config file:
<configuration>
<appSettings>
...
<add key="aspnet:GetValidationMemberName"  value="true"/>
...
</appSettings>
</configuration>
Esse comportamento mudará em uma versão de serviço futura, quando você precisará aceitar explicitamente o novo comportamento.This behavior will change in an upcoming service release, when you will have to explicitly opt in to the new behavior. A propriedade retornará um valor não nulo para um ValidationAttribute personalizado se a opção aspnet:GetValidationMemberName for definida como true.The property will return a non-null value for a custom ValidationAttribute if the aspnet:GetValidationMemberName switch is set to true.
EscopoScope UnknownUnknown
VersãoVersion 4.84.8
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

NúcleoCore

O .NET COM realiza marshaling bem-sucedido de parâmetros ByRef SafeArray em eventos.NET COM successfully marshals ByRef SafeArray parameters on events

DetalhesDetails No .NET Framework 4.7.2 e versões anteriores, um parâmetro ByRef SafeArray em um evento COM falharia realizar marshaling de volta para o código nativo.In the .NET Framework 4.7.2 and earlier versions, a ByRef SafeArray parameter on a COM event would fail to marshal back to native code. Com essa alteração, agora o marshal do SafeArray foi realizado com êxito.With this change the SafeArray is now marshalled successfully.
  • [x] Quirked[ x ] Quirked
SugestãoSuggestion Se a realização de marshal dos parâmetros ByRef SafeArray corretamente em eventos COM interromper a execução, será possível desabilitar esse código adicionando a seguinte opção de configuração à sua configuração de aplicativo:If properly marshalling ByRef SafeArray parameters on COM Events breaks execution, you can disable this code by adding the following configuration switch to your application config:
<appSettings>
<add key="Switch.System.Runtime.InteropServices.DoNotMarshalOutByrefSafeArrayOnInvoke" value="true" />
</appSettings>
EscopoScope SecundárioMinor
VersãoVersion 4.84.8
TipoType Tempo de execuçãoRuntime

A Interoperabilidade do .NET agora fará QueryInterface para IAgileObject (uma interface do WinRT).NET Interop will now QueryInterface for IAgileObject (a WinRT interface)

DetalhesDetails Ao usar um evento de WinRT com um delegado do .NET, Windows fará QI para IAgileObject começando com o .NET Framework 4.8.When using a WinRT event with a .NET delegate, Windows will QI for IAgileObject starting with the .NET Framework 4.8. Nas versões anteriores do .NET Framework, o tempo de execução falharia nessa QI e o evento não poderia ser assinado.In previous versions of the .NET Framework, the runtime would fail that QI, and the event could not be subscribed.
  • [x] Quirked[ x ] Quirked
SugestãoSuggestion Se a habilitação de QI para IAgileObject interromper a execução, você poderá desabilitar esse código definindo a configuração a seguir.If enabling the QI for IAgileObject breaks execution, you can disable this code by setting the following configuration.

Método 1: Variável de ambienteMethod 1: Environment variable

Defina a variável de ambiente a seguir:COMPLUS_DisableCCWSupportIAgileObject=1Esse método afeta qualquer ambiente que herda essa variável de ambiente.Set the following environment variable:COMPLUS_DisableCCWSupportIAgileObject=1This method affects any environment that inherits this environment variable. Isso pode ser apenas uma única sessão de console ou pode afetar o computador inteiro se você definir a variável de ambiente globalmente.This might be just a single console session, or it might affect the entire machine if you set the environment variable globally. O nome da variável de ambiente não diferencia maiúsculas de minúsculas.The environment variable name is not case-sensitive.

Método 2: RegistroMethod 2: Registry

Usando o Editor do Registro (regedit.exe), localize qualquer uma das seguintes subchaves:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft.NETFramework HKEY_CURRENT_USER\SOFTWARE\Microsoft.NETFrameworkEm seguida, adicione o seguinte:Nome do valor: DisableCCWSupportIAgileObject Tipo: DWORD (32 bits) Valor (também chamado REG_WORD) Valor: 1É possível usar a ferramenta REG.EXE do Windows para adicionar esse valor de uma linha de comando ou ambiente de script.Using Registry Editor (regedit.exe), find either of the following subkeys:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft.NETFramework HKEY_CURRENT_USER\SOFTWARE\Microsoft.NETFrameworkThen add the following:Value name: DisableCCWSupportIAgileObject Type: DWORD (32-bit) Value (also called REG_WORD) Value: 1You can use the Windows REG.EXE tool to add this value from a command-line or scripting environment. Por exemplo:For example:
reg add HKLM\SOFTWARE\Microsoft.NETFramework /v DisableCCWSupportIAgileObject /t REG_DWORD /d 1
Nesse caso, HKLM é usado em vez de HKEY_LOCAL_MACHINE.In this case, HKLM is used instead of HKEY_LOCAL_MACHINE. Use reg add /? para ver a ajuda nessa sintaxe.Use reg add /? to see help on this syntax. O nome do valor do registro não diferencia maiúsculas de minúsculas.The registry value name is not case-sensitive.
EscopoScope Microsoft EdgeEdge
VersionVersion 4.84.8
TipoType Tempo de execuçãoRuntime

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

Alteração de alto contraste de ComboBox de svcTraceViewersvcTraceViewer ComboBox high contrast change

DetalhesDetails Na ferramenta Visualizador de Rastreamento de Serviço da Microsoft, os controles ComboBox não eram exibidos na cor correta em determinados temas de alto contraste.In the Microsoft Service Trace Viewer tool, ComboBox controls were not displayed in the correct color in certain high contrast themes. O problema foi corrigido no .NET Framework 4.7.2.The issue was fixed in .NET Framework 4.7.2. No entanto, devido aos requisitos de compatibilidade com versões anteriores do SDK do .NET Framework, a correção não estava visível para clientes por padrão.However, due to .NET Framework SDK backward compatibility requirements, the fix was not visible to customers by default. O .NET 4.8 revela essa alteração adicionando os seguintes comutadores de configuração do AppContext ao arquivo svcTraceViewer.exe.config:.NET 4.8 surfaces this change by adding the following AppContext configuration switches to the svcTraceViewer.exe.config file:
<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />
SugestãoSuggestion
  • Como recusar a alteração Se você não quiser ter a alteração de comportamento de alto contraste, poderá desabilitá-la removendo a seguinte seção do arquivo svcTraceViewer.exe.config:How to opt out of the change If you don't want to have the high contrast behavior change, you can disable it by removing the following section from the svcTraceViewer.exe.config file:
<AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false;Switch.UseLegacyAccessibilityFeatures.2=false" />
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.84.8
TipoType Tempo de execuçãoRuntime

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

Melhoria de Associação de Dados para KeyedCollectionData Binding improvement for KeyedCollection

DetalhesDetails Corrigido Binding uso incorreto do indexador IList quando o objeto de origem declara um indexador personalizado com a mesma assinatura (por exemplo, Chaveid<int, TItem>).Fixed Binding incorrect use of IList indexer when the source object declares a custom indexer with the same signature (for example, KeyedCollection<int,TItem>).
SugestãoSuggestion Para que um aplicativo que tenha como alvo uma versão mais antiga se beneficie dessa alteração, ele deve ser executado no .NET Framework 4,8 ou posterior, e ele deve aceitar a alteração adicionando o seguinte comutador AppContext à seção <runtime> do arquivo de configuração do aplicativo e definindo-o como false:In order for an application that targets an older version to benefit from this change, it must run on the .NET Framework 4.8 or later, and it must opt in to the change by adding the following AppContext switch to the <runtime> section of the app config file and setting it to false:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7"/>
</startup>
<runtime>
<!-- AppContextSwitchOverrides value attribute is in the form of 'key1=true/false;key2=true/false  -->
<AppContextSwitchOverrides value="Switch.System.Windows.Data.Binding.IListIndexerHidesCustomIndexer=false" />
</runtime>
</configuration>
EscopoScope PrincipalMajor
VersionVersion 4.84.8
TipoType RuntimeRuntime

Correção de uma parada quando ListBox contém tipos de valor duplicadosFixed a hang when ListBox contains duplicate value-types

DetalhesDetails Correção de um problema em que um ItemsControl de virtualização pode parar de responder durante a rolagem quando a respectiva coleção Itens contém objetos com tipos de valor duplicados.Fixed a problem where a virtualizingItemsControl can hang during scrolling when its Items collection contains duplicate value-typed objects.
EscopoScope PrincipalMajor
VersãoVersion 4.84.8
TipoType Tempo de execuçãoRuntime

Melhorias no algoritmo de alocação de espaço de linhas de estrela da gradeImprovements to Grid star-rows space allocating algorithm

DetalhesDetails Correção de um bug no algoritmo para alocar tamanhos) em um Grid introduzido no .NET Framework 4.7.Fixed a bug in the algorithm for allocating sizes to) in a Grid introduced in .NET Framework 4.7. Em alguns casos, como uma grade com Height="Auto" contendo linhas vazias, as linhas foram organizadas na posição incorreta, possivelmente fora da grade.In some cases, such as a Grid with Height="Auto" containing empty rows, rows were arranged at the wrong position, possibly outside the Grid altogether.
SugestãoSuggestion Para que o aplicativo se beneficie dessas alterações, ele deve ser executado no .NET Framework 4.8 ou posterior.In order for the application to benefit from these changes, it must run on the .NET Framework 4.8 or later.
EscopoScope PrincipalMajor
VersãoVersion 4.84.8
TipoType Tempo de execuçãoRuntime
DetalhesDetails Correção do resultado incorreto de pressionar uma tecla de direção quando o foco está em um hiperlink dentro de um item que não é o item selecionado do ItemsControl pai.Fixed incorrect result of pressing an arrow key when the focus is on a hyperlink within an item that is not the selected item of the parent ItemsControl.
EscopoScope PrincipalMajor
VersãoVersion 4.84.8
TipoType Tempo de execuçãoRuntime

Melhoria de desempenho na árvore de automação para agrupar ItemsControlsPerformance improvement in Automation tree for grouping ItemsControls

DetalhesDetails Melhoria do desempenho de recompilação da árvore de automação de um ItemsControl, como um ListBox ou DataGrid, no qual o agrupamento está habilitado.Improved the performance of rebuilding the automation tree of an ItemsControl, such as a ListBox or DataGrid, in which grouping is enabled.
EscopoScope PrincipalMajor
VersãoVersion 4.84.8
TipoType Tempo de execuçãoRuntime