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

Se você estiver migrando do .NET Framework 4.6.2 para 4.7.2, 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.6.2 to 4.7.2, review the following topics for application compatibility issues that may affect your app:

NúcleoCore

Permitir Unicode em URIs semelhantes a compartilhamentos UNCAllow Unicode in URIs that resemble UNC shares

DetalhesDetails No System.Uri, a criação de um URI de arquivo contendo um nome do compartilhamento UNC e caracteres Unicode não resultará mais em um URI com estado interno inválido.In System.Uri, constructing a file URI containing both a UNC share name and Unicode characters will no longer result in a URI with invalid internal state. O comportamento será alterado somente quando todos os itens a seguir forem verdadeiros:The behavior will change only when all of the following are true:
  • O URI tiver o esquema file: e for seguido por quatro ou mais barras.The URI has the scheme file: and is followed by four or more slashes.
  • O nome do host começar com um sublinhado ou outro símbolo não reservado.The host name begins with an underscore or other non-reserved symbol.
  • O URI contiver caracteres Unicode.The URI contains Unicode characters.
SugestãoSuggestion Os aplicativos que funcionam com URIs que contêm Unicode de forma consistente podem ter aceitado o uso desse comportamento para não permitir referências a compartilhamentos UNC.Applications working with URIs consistently containing Unicode could have conceivably used this behavior to disallow references to UNC shares. Esses aplicativos devem usar IsUnc.Those applications should use IsUnc instead.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.7.24.7.2
TypeType RuntimeRuntime
APIs afetadasAffected APIs

Permitir notação de URI relativo especial quando o Unicode estiver presenteSupport special relative URI notation when Unicode is present

DetalhesDetails Urinão jogará NullReferenceException mais TryCreate um ao chamar certas URIs relativas contendo Unicode.Uri will no longer throw a NullReferenceException when calling TryCreate on certain relative URIs containing Unicode. A reprodução mais NullReferenceException simples do é abaixo, com as duas afirmações sendo equivalentes:The simplest reproduction of the NullReferenceException is below, with the two statements being equivalent:
bool success = Uri.TryCreate("http:%C3%A8", UriKind.RelativeOrAbsolute, out Uri href);
bool success = Uri.TryCreate("http:è", UriKind.RelativeOrAbsolute, out Uri href);
Para reproduzir a NullReferenceException, os itens a seguir precisam ser verdadeiros:To reproduce the NullReferenceException, the following items must be true:
  • O URI precisa ser especificado como relativo acrescentando 'http:' a ele e não inserindo '//' depois dele.The URI must be specified as relative by prepending it with ‘http:’ and not following it with ‘//’.
  • O URI precisa conter Unicode codificado por porcentagem ou símbolos não reservados.The URI must contain percent-encoded Unicode or unreserved symbols.
SugestãoSuggestion Os usuários que dependem desse comportamento para não permitir URIs relativos precisam especificar UriKind.Absolute durante a criação de um URI.Users depending on this behavior to disallow relative URIs should instead specify UriKind.Absolute when creating a URI.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.7.24.7.2
TypeType RuntimeRuntime
APIs afetadasAffected APIs

RuntimeRuntime

Melhor validação do certificado de confiança de cadeia do WCF para autenticação de certificado do Net.TcpImproved WCF chain trust certificate validation for Net.Tcp certificate authentication

DetalhesDetails O .NET framework 4.7.2 melhorou a validação do certificado de confiança de cadeia ao usar a autenticação de certificado com a segurança de transporte com o WCF..NET Framework 4.7.2 improves chain trust certificate validation when using certificate authentication with transport security with WCF. Com essa melhoria, os certificados do cliente que são usados para autenticar um servidor precisam ser configurados para autenticação do cliente.With this improvement, client certificates that are used to authenticate to a server must be configured for client authentication. Da mesma forma, os certificados do servidor usados para autenticar um servidor precisam ser configurados para autenticação do servidor.Similarly server certificates that are for the authenticating a server must be configured for server authentication. Com essa alteração, se o certificado raiz for desabilitado, a validação da cadeia de certificados falhará.With this change, if the root certificate is disabled, the certificate chain validation fails. A mesma alteração também foi feita para o .NET Framework 3.5 e as versões posteriores por meio do pacote cumulativo de segurança do Windows.The same change was also made to .NET Framework 3.5 and later versions via Windows security roll-up. Encontre mais informações aqui. Essa alteração é habilitada por padrão e pode ser desabilitada por uma definição de configuração.You can find more information here.This change is on by default and can be turned off by a configuration setting.
SugestãoSuggestion
  • Valide se a certificação do servidor e do cliente têm o OID de EKU necessário.Validate if your server and client certification has the required EKU OID. Caso contrário, atualize a certificação.If not, update your certification.
  • Valide se o certificado raiz é inválido.Validate if your root certificate is invalid. Nesse caso, atualize o certificado raiz.If so, update the root certificate.
  • Como recusar a alteração: se você não puder atualizar o certificado, contorne temporariamente a alteração da falha com as definições de configuração a seguir. No entanto, recusar a alteração deixará seu sistema vulnerável ao problema de segurança.How to opt out of the change: If you can't update the certificate, you can work around the breaking change temporarily with the following configration setting, However, opting out of the change will leave your system vulnerable to the security issue.
<appSettings>
<add key="wcf:useLegacyCertificateUsagePolicy" value="true" />
</appSettings>
EscopoScope SecundáriaMinor
VersãoVersion 4.7.24.7.2
TypeType RuntimeRuntime

SegurançaSecurity

RSACng e DSACng podem ser usados novamente em cenários de confiança parcialRSACng and DSACng are once again usable in Partial Trust scenarios

DetalhesDetails CngLightup (usado em várias APIs de criptografia de nível mais elevado, como System.Security.Cryptography.Xml.EncryptedXml) e System.Security.Cryptography.RSACng, em alguns casos, dependem da confiança total.CngLightup (used in several higher-level crypto apis, such as System.Security.Cryptography.Xml.EncryptedXml) and System.Security.Cryptography.RSACng in some cases rely on full trust. Eles incluem P/Invokes sem declarar permissões de SecurityPermissionFlag.UnmanagedCode e caminhos de código em que System.Security.Cryptography.CngKey tem demandas de permissão de SecurityPermissionFlag.UnmanagedCode.These include P/Invokes without asserting SecurityPermissionFlag.UnmanagedCode permissions, and code paths where System.Security.Cryptography.CngKey has permission demands for SecurityPermissionFlag.UnmanagedCode. A partir do .NET Framework 4.6.2, CngLightup foi usado para mudar para System.Security.Cryptography.RSACng sempre que possível.Starting with the .NET Framework 4.6.2, CngLightup was used to switch to System.Security.Cryptography.RSACng wherever possible. Como resultado, aplicativos de confiança parcial que usavam System.Security.Cryptography.Xml.EncryptedXml com êxito começaram a falhar e a lançar exceções SecurityException. Essa alteração adiciona as declarações necessárias para que todas as funções que usam CngLightup tenham as permissões necessárias.As a result, partial trust apps that successfully used System.Security.Cryptography.Xml.EncryptedXml began to fail and throw SecurityException exceptions.This change adds the required asserts so that all functions using CngLightup have the required permissions.
SugestãoSuggestion Se essa alteração do .NET Framework 4.6.2 tiver afetado seus aplicativos de confiança parcial de forma negativa, atualize para o .NET Framework 4.7.1.If this change in the .NET Framework 4.6.2 has negatively impacted your partial trust apps, upgrade to the .NET Framework 4.7.1.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.6.24.6.2
TypeType RuntimeRuntime
APIs afetadasAffected APIs

Aplicativos WebWeb Applications

A configuração de aplicativo "dataAnnotations:dataTypeAttribute:disableRegEx" é habilitada por padrão no .NET Framework 4.7.2"dataAnnotations:dataTypeAttribute:disableRegEx" app setting is on by default in .NET Framework 4.7.2

DetalhesDetails No .NET Framework 4.6.1, foi introduzida uma configuração de aplicativo ("dataAnnotations:dataTypeAttribute:disableRegEx") que permite que os usuários desabilitem o uso de expressões regulares em atributos de tipo de dados (como System.ComponentModel.DataAnnotations.EmailAddressAttribute, System.ComponentModel.DataAnnotations.UrlAttribute e System.ComponentModel.DataAnnotations.PhoneAttribute).In .NET Framework 4.6.1, an app setting ("dataAnnotations:dataTypeAttribute:disableRegEx") was introduced that allows users to disable the use of regular expressions in data type attributes (such as System.ComponentModel.DataAnnotations.EmailAddressAttribute, System.ComponentModel.DataAnnotations.UrlAttribute, and System.ComponentModel.DataAnnotations.PhoneAttribute). Isso ajuda a reduzir vulnerabilidades de segurança, por exemplo, impedindo que um ataque de negação de serviço use expressões regulares específicas.This helps to reduce security vulnerability such as avoiding the possibility of a Denial of Service attack using specific regular expressions.
No .NET Framework 4.6.1, essa configuração de aplicativo para desabilitar o uso de expressões regulares era definida como false por padrão.In .NET Framework 4.6.1, this app setting to disable RegEx usage was set to false by default. Começando com o .NET Framework 4.7.2, true este switch de configuração é definido por padrão para reduzir ainda mais a vulnerabilidade segura para aplicativos web que visam o .NET Framework 4.7.2 ou superior.Starting with .NET Framework 4.7.2, this config switch is set to true by default to further reduce secure vulnerability for web applications that target .NET Framework 4.7.2 and above.
SugestãoSuggestion Se observar que as expressões regulares em seu aplicativo Web não funcionam após atualizar para o .NET Framework 4.7.2, você poderá atualizar o valor da "dataAnnotations:dataTypeAttribute:disableRegEx" configuração false para voltar ao comportamento anterior.If you find that regular expressions in your web application do not work after upgrading to .NET Framework 4.7.2, you can update the value of the "dataAnnotations:dataTypeAttribute:disableRegEx" setting to false to revert to the previous behavior.
<configuration>
<appSettings>
...
<add key="dataAnnotations:dataTypeAttribute:disableRegEx" value="false"/>
...
</appSettings>
</configuration>
EscopoScope SecundáriaMinor
VersãoVersion 4.7.24.7.2
TypeType RuntimeRuntime

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

AddressHeaderCollection do WCF agora gera ArgumentException se um elemento addressHeader for nuloWCF AddressHeaderCollection now throws an ArgumentException if an addressHeader element is null

DetalhesDetails A partir do .NET Framework 4.7.1, o construtor AddressHeaderCollection(IEnumerable<AddressHeader>) gera ArgumentException se um elemento for null.Starting with the .NET Framework 4.7.1, the AddressHeaderCollection(IEnumerable<AddressHeader>) constructor throws an ArgumentException if one of the elements is null. No .NET Framework 4.7 e versões anteriores, nenhuma exceção é gerada.In the .NET Framework 4.7 and earlier versions, no exception is thrown.
SugestãoSuggestion Se houver problemas de compatibilidade com essa alteração no .NET Framework 4.7.1 ou uma versão anterior, será possível recusá-la adicionando a seguinte linha à seção <runtime> do arquivo app.config:If you encounter compatibility issues with this change on the .NET Framework 4.7.1 or a later version, you can opt-out of it by adding the following line to the <runtime> section of the app.config file::
<configuration>
<runtime>
<AppContextSwitchOverrides value="Switch.System.ServiceModel.DisableAddressHeaderCollectionValidation=true" />
</runtime>
</configuration>
EscopoScope SecundáriaMinor
VersãoVersion 4.7.14.7.1
TypeType RuntimeRuntime
APIs afetadasAffected APIs

O valor padrão MsmqSecureHashAlgorithm do WCF agora é SHA256WCF MsmqSecureHashAlgorithm default value is now SHA256

DetalhesDetails A partir do .NET Framework 4.7.1, o algoritmo de assinatura da mensagem padrão no WCF para mensagens Msmq é SHA256.Starting with the .NET Framework 4.7.1, the default message signing algorithm in WCF for Msmq messages is SHA256. No .NET Framework 4.7 e versões anteriores, o algoritmo de assinatura da mensagem padrão é SHA1.In the .NET Framework 4.7 and earlier versions, the default message signing algorithm is SHA1.
SugestãoSuggestion Se houver problemas de compatibilidade com essa alteração no .NET Framework 4.7.1 ou uma versão posterior, será possível recusá-la adicionando a seguinte linha à seção <runtime> do arquivo app.config:If you run into compatibility issues with this change on the .NET Framework 4.7.1 or later, you can opt-out the change by adding the following line to the <runtime>section of your app.config file:
<configuration>
<runtime>
<AppContextSwitchOverrides value="Switch.System.ServiceModel.UseSha1InMsmqEncryptionAlgorithm=true" />
</runtime>
</configuration>
EscopoScope SecundáriaMinor
VersãoVersion 4.7.14.7.1
TypeType RuntimeRuntime

PipeConnection.GetHashAlgorithm do WCF agora usa o SHA256WCF PipeConnection.GetHashAlgorithm now uses SHA256

DetalhesDetails A partir do .NET Framework 4.7.1, o Windows Communication Foundation usa o hash SHA256 para gerar nomes aleatórios para pipes nomeados.Starting with the .NET Framework 4.7.1, Windows Communication Foundation uses a SHA256 hash to generate random names for named pipes. No .NET Framework 4.7 e nas versões anteriores, ele usa o hash SHA1.In the .NET Framework 4.7 and earlier versions, it used a SHA1 hash.
SugestãoSuggestion Se houver problemas de compatibilidade com essa alteração no .NET Framework 4.7.1 ou uma versão posterior, é possível recusá-la adicionando a seguinte linha à seção <runtime> do arquivo app.config:If you run into compatibility issue with this change on the .NET Framework 4.7.1 or later, you can opt-out it by adding the following line to the <runtime> section of your app.config file:
<configuration>
<runtime>
<AppContextSwitchOverrides value="Switch.System.ServiceModel.UseSha1InPipeConnectionGetHashAlgorithm=true" />
</runtime>
</configuration>
EscopoScope SecundáriaMinor
VersãoVersion 4.7.14.7.1
TypeType RuntimeRuntime

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

Pop-ups encadeados com StaysOpen=FalseChained Popups with StaysOpen=False

DetalhesDetails Um pop-up com StaysOpen=False deve fechar quando você clica fora dele.A Popup with StaysOpen=False is supposed to close when you click outside the Popup. Quando dois ou mais pop-ups do tipo estão encadeados (por exemplo, quando um contém o outro), há muitos problemas, incluindo:When two or more such Popups are chained (i.e. one contains another), there were many problems, including:
  • Abra dois níveis, clique fora do P2, mas dentro do P1.Open two levels, click outside P2 but inside P1. Nada acontecerá.Nothing happens.
  • Abra dois níveis, clique fora do P1.Open two levels, click outside P1. Ambos pop-ups serão fechados.Both popups close.
  • Abra e feche dois níveis.Open and close two levels. Em seguida, tente abrir novamente o P2.Then try to open P2 again. Nada acontecerá.Nothing happens.
  • Tente abrir três níveis.Try to open three levels. Não é possível fazer isso.You can't. (Ou nada acontece ou os dois primeiros níveis fecham, dependendo de onde você clica.) Esses casos (e outras variantes) agora funcionam como esperado.(Either nothing happens or the first two levels close, depending on where you click.) These cases (and other variants) now work as expected.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.7.14.7.1
TypeType RuntimeRuntime
APIs afetadasAffected APIs

DataGridCellsPanel.BringIndexIntoView gera ArgumentOutOfRangeExceptionDataGridCellsPanel.BringIndexIntoView throws ArgumentOutOfRangeException

DetalhesDetails ScrollIntoView(Object) será executado assincronamente quando a virtualização de coluna estiver habilitada, mas as larguras das colunas ainda não estiverem determinadas.ScrollIntoView(Object) will work asynchronously when column virtualization is enabled but the column widths have not yet been determined. Se as colunas forem removidas antes da operação assíncrona, um ArgumentOutOfRangeException poderá ocorrer.If columns are removed before the asynchronous work happens, an ArgumentOutOfRangeException can occur.
SugestãoSuggestion Siga um destes procedimentos:Any one of the following:
  1. Atualize para o .NET Framework 4.7.Upgrade to .NET Framework 4.7.
  2. Instale o patch de manutenção mais recente para o .NET Framework 4.6.2.Install the latest servicing patch for .NET Framework 4.6.2.
  3. Evitar remover colunas até que a resposta assíncrona ao método ScrollIntoView(Object) seja concluída.Avoid removing columns until the asynchronous response to ScrollIntoView(Object) has completed.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.6.24.6.2
TypeType RuntimeRuntime
APIs afetadasAffected APIs

Melhoria no comportamento das dicas de tecla no WPFKeytips behavior improved in WPF

DetalhesDetails O comportamento das dicas de tecla foi modificado para manter a paridade com o comportamento no Microsoft Word e no Windows Explorer.Keytips behavior has been modified to bring parity with behavior on Microsoft Word and Windows Explorer. Ao verificar se o estado da dica de tecla está habilitado ou não no caso de uma SystemKey (especificamente, Key ou F11) que está sendo pressionada, o WPF trata corretamente as teclas de dica de tecla.By checking whether keytip state is enabled or not in the case of a SystemKey (in particular, Key or F11) being pressed, WPF handles keytip keys appropriately. As dicas de tecla agora descartam um menu, mesmo quando ele é aberto pelo mouse.Keytips now dismiss a menu even when it is opened by mouse.
SugestãoSuggestion N/DN/A
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.7.24.7.2
TypeType RuntimeRuntime

ObjectDisposedException gerada pelo verificador ortográfico do WPFObjectDisposedException thrown by WPF spellchecker

DetalhesDetails Ocasionalmente, os aplicativos WPF falham durante o desligamento com uma ObjectDisposedException gerada pelo verificador ortográfico.WPF applications occasionally crash during application shutdown with an ObjectDisposedException thrown by the spellchecker. Isso foi corrigido no WPF do .NET Framework 4.7 por meio do tratamento normal da exceção, garantindo que os aplicativos não sejam mais prejudicados.This is fixed in .NET Framework 4.7 WPF by handling the exception gracefully, and thus ensuring that applications are no longer adversely affected. Observe que exceções de primeira chance ocasionais continuariam a ser observadas em aplicativos em execução em um depurador.It should be noted that occasional first-chance exceptions would continue to be observed in applications running under a debugger.
SugestãoSuggestion Atualizar para o .NET Framework 4.7Upgrade to .NET Framework 4.7
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.6.14.6.1
TypeType RuntimeRuntime

Tela de fundo RibbonGroup é definida como transparente em builds localizadosRibbonGroup background is set to transparent in localized builds

DetalhesDetails A tela de fundo RibbonGroup em builds localizados sempre foi pintada com um pincel Transparente, o que resultava em uma experiência de interface do usuário ruim.RibbonGroup background on localized builds was always painted with Transparent brush, resulting in poor UI experience. Isso foi corrigido no WPF do .NET Framework 4.7 por meio da atualização dos recursos localizados para RibbonGroup, que, por sua vez, garante que o pincel correto seja selecionado.This is fixed in .NET Framework 4.7 WPF fix by updating the localized resources for RibbonGroup, which in turn ensures that the correct brush is selected.
SugestãoSuggestion Atualizar para o .NET Framework 4.7Upgrade to .NET Framework 4.7
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.6.24.6.2
TypeType RuntimeRuntime

Atualização da pilha de impressão do WPFWPF Printing Stack Update

DetalhesDetails Agora, as APIs de Impressão do WPF que usam PrintQueuechamam a API de Impressão Pacote de Documentos do Windows em vez da API de Impressão XPS, que foi preterida.WPF's Printing APIs using PrintQueue now call Window's Print Document Package API in favor of the now deprecated XPS Print API. A alteração foi feita para fins de manutenção. Nem usuários nem os desenvolvedores devem ver todas as alterações no comportamento ou no uso da API.The change was made with serviceability in mind; neither users nor developers should see any changes in behavior or API usage. A nova pilha de impressão é habilitada por padrão ao ser executada na Atualização do Windows 10 para Criadores.The new printing stack is enabled by default when running in Windows 10 Creators Update. A pilha de impressão antiga continuará a funcionar como antes nas versões mais antigas do Windows.The old printing stack will still continue to work just as before in older Windows versions.
SugestãoSuggestion Para usar a pilha antiga na Atualização do Windows 10 para Criadores, defina o valor REG_DWORD UseXpsOMPrinting da chave do Registro HKEY_CURRENT_USER\Software\Microsoft.NETFramework\Windows Presentation Foundation\Printing como 1.To use the old stack in Windows 10 Creators Update, set the UseXpsOMPrinting REG_DWORD value of the HKEY_CURRENT_USER\Software\Microsoft.NETFramework\Windows Presentation Foundation\Printing registry key to 1.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.74.7
TypeType RuntimeRuntime

Windows Workflow Foundation (WF)Windows Workflow Foundation (WF)

Agora, o fluxo de trabalho gera a exceção original em vez de NullReferenceException em alguns casosWorkflow now throws original exception instead of NullReferenceException in some cases

DetalhesDetails No .NET Framework 4.6.2 e versões anteriores, quando o método Executar de uma atividade de fluxo de trabalho gera uma exceção com um valor null para a propriedade Message, o runtime do fluxo de trabalho System.Activities gera NullReferenceException, mascarando a exceção original. No .NET Framework 4.7, a exceção mascarada anteriormente é gerada.In the .NET Framework 4.6.2 and earlier versions, when the Execute method of a workflow activity throws an exception with a null value for the Message property, the System.Activities Workflow runtime throws a NullReferenceException, masking the original exception.In the .NET Framework 4.7, the previously masked exception is thrown.
SugestãoSuggestion Se o código depender do tratamento de NullReferenceException, altere-o para capturar as exceções que possam ser geradas por meio das atividades personalizadas.If your code relies on handling the NullReferenceException, change it to catch the exceptions that could be thrown from your custom activities.
EscopoScope SecundáriaMinor
VersãoVersion 4.74.7
TypeType RuntimeRuntime
APIs afetadasAffected APIs

Persistência do fluxo de trabalho SQL adiciona clusters de chave primária e não permite valores nulos em algumas colunasWorkflow SQL persistence adds primary key clusters and disallows null values in some columns

DetalhesDetails A partir do .NET Framework 4.7, as tabelas criadas para a SWIS (SQL Workflow Instance Store) pelo script SqlWorkflowInstanceStoreSchema.sql usarão chaves primárias em clusters.Starting with the .NET Framework 4.7, the tables created for the SQL Workflow Instance Store (SWIS) by the SqlWorkflowInstanceStoreSchema.sql script use clustered primary keys. Por isso, as identidades não são compatíveis com valores null.Because of this, identities do not support null values. A operação da SWIS não é afetada por essa alteração.The operation of SWIS is not impacted by this change. As atualizações foram feitas serem compatíveis com replicação transacional do SQL Server.The updates were made to support SQL Server Transactional Replication.
SugestãoSuggestion O arquivo SQL SqlWorkflowInstanceStoreSchemaUpgrade.sql deve ser aplicado a instalações existentes para usar essa alteração.The SQL file SqlWorkflowInstanceStoreSchemaUpgrade.sql must be applied to existing installations in order to experience this change. Novas instalações de banco de dados serão alteradas automaticamente.New database installations will automatically have the change.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.74.7
TypeType RuntimeRuntime