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

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

ASP.NETASP.NET

GridViews com AllowCustomPaging definido como verdadeiro pode acionar o evento PageIndexChanging ao deixar a página final do modo de exibiçãoGridViews with AllowCustomPaging set to true may fire the PageIndexChanging event when leaving the final page of the view

DetalhesDetails Um bug no .NET Framework 4.5 faz com que PageIndexChanging, às vezes, não seja acionado para GridViews com AllowCustomPaging habilitado.A bug in the .NET Framework 4.5 causes PageIndexChanging to sometimes not fire for GridViews that have enabled AllowCustomPaging.
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. Como solução alternativa, o aplicativo pode fazer um BindGrid explícito em qualquer Page_Load que respeite essas condições (o GridView está na última página e LastPageSize é diferente de PageSize).As a work-around, the app can do an explicit BindGrid on any Page_Load that would hit these conditions (the GridView is on the last page and LastPageSize is different from PageSize). Como alternativa, o aplicativo pode ser modificado para permitir a paginação (em vez da paginação personalizada), uma vez que esse cenário não demonstra o problema.Alternatively, the app can be modified to allow paging (instead of custom paging), as that scenario does not demonstrate the problem.
EscopoScope SecundárioMinor
VersãoVersion 4.54.5
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

AppDomainSetup.DynamicBase não é mais randomizado por UseRandomizedStringHashAlgorithmAppDomainSetup.DynamicBase is no longer randomized by UseRandomizedStringHashAlgorithm

DetalhesDetails Antes do .NET Framework 4.6, o valor de DynamicBase seria randomizado entre domínios de aplicativos ou entre processos se UseRandomizedStringHashAlgorithm estivesse habilitado no arquivo de configuração do aplicativo.Prior to the .NET Framework 4.6, the value of DynamicBase would be randomized between application domains, or between processes, if UseRandomizedStringHashAlgorithm was enabled in the app's config file. A partir do .NET Framework 4.6, DynamicBase retornará um resultado estável entre instâncias diferentes de um aplicativo em execução e entre diferentes domínios de aplicativo.Beginning in the .NET Framework 4.6, DynamicBase will return a stable result between different instances of an app running, and between different app domains. Bases dinâmicas ainda serão diferentes para diferentes aplicativos. Essa alteração remove apenas o elemento de nomenclatura aleatório para instâncias diferentes do mesmo aplicativo.Dynamic bases will still differ for different apps; this change only removes the random naming element for different instances of the same app.
SugestãoSuggestion Lembre-se de que habilitar UseRandomizedStringHashAlgorithm não fará com que DynamicBase seja randomizado.Be aware that enabling UseRandomizedStringHashAlgorithm will not result in DynamicBase being randomized. Se for necessária uma base aleatória, ela deverá ser produzida no código do aplicativo, e não por meio dessa API.If a random base is needed, it must be produced in your app's code rather than via this API.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Chamar Attribute.GetCustomAttributes na propriedade de um indexador não vai mais gerar AmbiguousMatchException se a ambiguidade puder ser resolvida pelo tipo do índiceCalling Attribute.GetCustomAttributes on an indexer property no longer throws AmbiguousMatchException if the ambiguity can be resolved by index's type

DetalhesDetails Antes do .NET Framework 4.6, chamar GetCustomAttribute(s) na propriedade de um indexador que diferia de outra propriedade apenas pelo tipo do índice resultaria em um AmbiguousMatchException.Prior to the .NET Framework 4.6, calling GetCustomAttribute(s) on an indexer property which differed from another property only by the type of the index would result in an AmbiguousMatchException. A partir do .NET Framework 4.6, os atributos da propriedade serão corretamente retornados.Beginning in the .NET Framework 4.6, the property's attributes will be correctly returned.
SugestãoSuggestion Lembre-se de que GetCustomAttribute(s) funcionará com mais frequência agora.Be aware that GetCustomAttribute(s) will work more frequently now. Se um aplicativo anteriormente contava com o AmbiguousMatchException, a reflexão agora deverá ser usada para procurar explicitamente vários indexadores.If an app was previously relying on the AmbiguousMatchException, reflection should now be used to explicitly look for multiple indexers, instead.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.64.6
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

EventListeners do ETW não capturam eventos dos provedores com palavras-chave explícitas (como o provedor TPL)ETW EventListeners do not capture events from providers with explicit keywords (like the TPL provider)

DetalhesDetails EventListeners do ETW com uma máscara de palavra-chave em branco não capturam eventos corretamente dos provedores com palavras-chave explícitas.ETW EventListeners with a blank keyword mask do not properly capture events from providers with explicit keywords. No .NET Framework 4.5, o provedor TPL começou a fornecer palavras-chave explícitas e disparou esse problema.In the .NET Framework 4.5, the TPL provider began providing explicit keywords and triggered this issue. No .NET Framework 4.6, EventListeners foram atualizados para não apresentarem mais esse problema.In the .NET Framework 4.6, EventListeners have been updated to no longer have this issue.
SugestãoSuggestion Para contornar esse problema, substitua as chamadas para EnableEvents(EventSource, EventLevel) com chamadas para a sobrecarga EnableEvents que especifica explicitamente a máscara "quaisquer palavras-chave" a ser usada: EnableEvents(eventSource, level, unchecked((EventKeywords)0xFFFFffffFFFFffff)). Como alternativa, esse problema foi corrigido no .NET Framework 4.6 e pode ser resolvido com o upgrade para essa versão do .NET Framework.To work around this problem, replace calls to EnableEvents(EventSource, EventLevel) with calls to the EnableEvents overload that explicitly specifies the "any keywords" mask to use: EnableEvents(eventSource, level, unchecked((EventKeywords)0xFFFFffffFFFFffff)).Alternatively, 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 Microsoft EdgeEdge
VersãoVersion 4.54.5
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

O calendário persa agora usa o algoritmo solar islâmicoPersian calendar now uses the Hijri solar algorithm

DetalhesDetails A partir do .NET Framework 4.6, a classe PersianCalendar usa o algoritmo solar islâmico.Starting with the .NET Framework 4.6, the PersianCalendar class uses the Hijri solar algorithm. Converter datas entre o PersianCalendar e outros calendários pode produzir um resultado um pouco diferente começando com o .NET Framework 4.6 para datas anteriores a 1800 ou posteriores a 2023 (gregoriano). Além disso, agora PersianCalendar.MinSupportedDateTime é March 22, 0622 em vez de March 21, 0622.Converting dates between the PersianCalendar and other calendars may produce a slightly different result beginning with the .NET Framework 4.6 for dates earlier than 1800 or later than 2023 (Gregorian).Also, PersianCalendar.MinSupportedDateTime is now March 22, 0622 instead of March 21, 0622.
SugestãoSuggestion Lembre-se de que algumas datas anteriores ou posteriores podem ser um pouco diferentes quando se usa o PersianCalendar no .NET Framework 4.6.Be aware that some early or late dates may be slightly different when using the PersianCalendar in .NET Framework 4.6. Além disso, ao serializar datas entre processos que podem ser executados em diferentes versões do .NET Framework, não armazene-as como cadeias de caracteres de data PersianCalendar (uma vez que esses valores podem ser diferentes).Also, when serializing dates between processes which may run on different .NET Framework versions, do not store them as PersianCalendar date strings (since those values may be different).
EscopoScope SecundárioMinor
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Os objetos Reflection não podem mais ser passados de código gerenciado para clientes DCOM fora do processoReflection objects can no longer be passed from managed code to out-of-process DCOM clients

DetalhesDetails Os objetos Reflection não podem mais ser passados de código gerenciado para clientes DCOM fora do processo.Reflection objects can no longer be passed from managed code to out-of-process DCOM clients. Os seguintes tipos são afetados:The following types are affected:Chamadas a IMarshal para o retorno do objeto E_NOINTERFACE.Calls to IMarshal for the object return E_NOINTERFACE.
SugestãoSuggestion Atualize o código de marshaling para trabalhar com objetos de não reflexãoUpdate marshaling code to work with non-reflection objects
EscopoScope SecundárioMinor
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime

TargetFrameworkName para o domínio de aplicativo padrão não será mais padronizado como nulo se não for definidoTargetFrameworkName for default app domain no longer defaults to null if not set

DetalhesDetails O TargetFrameworkName era nulo anteriormente no domínio de aplicativo padrão, a menos que fosse explicitamente definido.The TargetFrameworkName was previously null in the default app domain, unless it was explicitly set. A partir da 4.6, a propriedade TargetFrameworkName para o domínio de aplicativo padrão terá um valor padrão derivado do TargetFrameworkAttribute (se um estiver presente).Beginning in 4.6, the TargetFrameworkName property for the default app domain will have a default value derived from the TargetFrameworkAttribute (if one is present). Os domínios de aplicativo não padrão continuarão herdando o respectivo TargetFrameworkName do domínio de aplicativo padrão (que não será padronizado para nulo na 4.6), a menos que sejam explicitamente substituídos.Non-default app domains will continue to inherit their TargetFrameworkName from the default app domain (which will not default to null in 4.6) unless it is explicitly overridden.
SugestãoSuggestion O código deve ser atualizado para não depender do TargetFrameworkName que padroniza para nulo.Code should be updated to not depend on TargetFrameworkName defaulting to null. Se for necessário que essa propriedade continue sendo avaliada como nula, ela poderá ser explicitamente definida para esse valor.If it is required that this property continue to evaluate to null, it can be explicitly set to that value.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Agora, o X509Certificate2.ToString(Boolean) não é gerado quando o .NET não pode tratar o certificadoX509Certificate2.ToString(Boolean) does not throw now when .NET cannot handle the certificate

DetalhesDetails No .NET Framework 4.5.2 e nas versões anteriores, esse método era gerado quando true era passado para o parâmetro verbose e havia certificados instalados que não eram compatíveis com o .NET Framework.In .NET Framework 4.5.2 and earlier versions, this method would throw if true was passed for the verbose parameter and there were certificates installed that weren't supported by the .NET Framework. Agora, o método será bem-sucedido e retornará uma cadeia de caracteres válida que omita as partes inacessíveis do certificado.Now, the method will succeed and return a valid string that omits the inaccessible portions of the certificate.
SugestãoSuggestion Qualquer código dependente do X509Certificate2.ToString(Boolean) deve ser atualizado para esperar que a cadeia de caracteres retornada possa excluir alguns dados do certificado (como chave pública, chave privada e extensões) em alguns casos nos quais a API teria sido gerada anteriormente.Any code depending on X509Certificate2.ToString(Boolean) should be updated to expect that the returned string may exclude some certificate data (such as public key, private key, and extensions) in some cases in which the API would have previously thrown.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

DadosData

Período de bloqueio do pool de conexões para bancos de dados SQL do Azure removidoConnection pool blocking period for Azure SQL databases is removed

DetalhesDetails A partir do .NET Framework 4.6.2, para solicitações de abertura da conexão com bancos de dados SQL do Azure conhecidos (*.database.windows.net, *.database.chinacloudapi.cn, *.database.usgovcloudapi.net, *.database.cloudapi.de), o período de bloqueio do pool de conexões foi removido e os erros de abertura da conexão não são armazenados em cache.Starting with the .NET Framework 4.6.2, for connection open requests to known Azure SQL databases (*.database.windows.net, *.database.chinacloudapi.cn, *.database.usgovcloudapi.net, *.database.cloudapi.de), the connection pool blocking period is removed, and connection open errors are not cached. As tentativas de repetir as solicitações de abertura de conexão ocorrerão quase que imediatamente após os erros de conexão transitórios.Attempts to retry connection open requests will occur almost immediately after transient connection errors. Essa alteração permite que a tentativa de abertura da conexão seja repetida imediatamente para bancos de dados SQL do Azure, melhorando, assim, o desempenho dos aplicativos habilitados para a nuvem.This change allows the connection open attempt to be retried immediately for Azure SQL databases, thereby improving the performance of cloud- enabled apps. Para todas as outras tentativas de conexão, o período de bloqueio do pool de conexões continuará sendo imposto.For all other connection attempts, the connection pool blocking period continues to be enforced.

No .NET Framework 4.6.1 e nas versões anteriores, quando um aplicativo encontra uma falha de conexão transitória ao conectar-se a um banco de dados, a tentativa de conexão não pode ser repetida rapidamente porque o pool de conexões armazena o erro em cache e gera-o novamente por um tempo que varia de 5 segundos a 1 minuto.In the .NET Framework 4.6.1 and earlier versions, when an app encounters a transient connection failure when connecting to a database, the connection attempt cannot be retried quickly, because the connection pool caches the error and re-throws it for 5 seconds to 1 minute. Para obter mais informações, confira Pooling de conexão do SQL Server (ADO.NET).For more information, see SQL Server Connection Pooling (ADO.NET). Esse comportamento é problemático para conexões com bancos de dados SQL do Azure que, muitas vezes, falham com erros transitórios que normalmente são recuperados em alguns segundos.This behavior is problematic for connections to Azure SQL databases, which often fail with transient errors that are typically recovered from within a few seconds. O recurso de bloqueio do pool de conexões significa que o aplicativo não pode se conectar ao banco de dados por um período extenso, mesmo que o banco de dados esteja disponível e o aplicativo precise ser renderizado em alguns segundos.The connection pool blocking feature means that the app cannot connect to the database for an extensive period, even though the database is available and the app needs to render within a few seconds.

SugestãoSuggestion Se esse comportamento for indesejável, o período de bloqueio do pool de conexões poderá ser configurado definindo a propriedade PoolBlockingPeriod introduzida no .NET Framework 4.6.2.If this behavior is undesirable, the connection pool blocking period can be configured by setting the PoolBlockingPeriod property introduced in the .NET Framework 4.6.2. O valor da propriedade é membro da enumeração PoolBlockingPeriod que pode assumir um dos três valores:The value of the property is a member of the PoolBlockingPeriod enumeration that can take either of three values:É possível restaurar o comportamento anterior definindo a propriedade PoolBlockingPeriod como AlwaysBlock.The previous behavior can be restored by setting the PoolBlockingPeriod property to AlwaysBlock.
EscopoScope SecundárioMinor
VersãoVersion 4.6.24.6.2
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

DepuradorDebugger

Valores nulos de união não são visíveis no depurador até uma etapa posteriorNull coalescer values are not visible in debugger until one step later

DetalhesDetails Um bug no .NET Framework 4.5 faz com que os valores definidos por meio de uma operação de união nula não fiquem visíveis no depurador imediatamente após a operação de atribuição ser executada na versão de 64 bits do Framework.A bug in the .NET Framework 4.5 causes values set via a null coalescing operation to not be visible in the debugger immediately after the assignment operation is executed when running on the 64-bit version of the Framework.
SugestãoSuggestion Colocar um tempo adicional no depurador fará com que o valor do local/campo seja atualizado corretamente.Stepping one additional time in the debugger will cause the local/field's value to be correctly updated. Além disso, esse problema foi corrigido no .NET Framework 4.6 e pode ser resolvido com o upgrade para essa versão do .NET Framework.Also, this issue has been fixed in the .NET Framework 4.6; upgrading to that version of the Framework should solve the issue.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.54.5
TipoType Tempo de execuçãoRuntime

GlobalizaçãoGlobalization

Categorias do padrão Unicode versão 8.0 agora são compatíveisUnicode standard version 8.0 categories now supported

DetalhesDetails No .NET Framework 4.6.2, os dados Unicode foram atualizados do Unicode Standard versão 6.3 para a versão 8.0.In .NET Framework 4.6.2, Unicode data has been upgraded from Unicode Standard version 6.3 to version 8.0. Ao solicitar a categorias de caracteres Unicode no .NET Framework 4.6.2, alguns resultados poderão não corresponder aos resultados nas versões anteriores do .NET Framework.When requesting Unicode character categories in .NET Framework 4.6.2, some results might not match the results in previous .NET Framework versions. Essa alteração afeta principalmente as sílabas Cheroqui, bem como os símbolos vocálicos e as marcas de tom Tai Lue Novo.This change mostly affects Cherokee syllables and New Tai Lue vowels signs and tone marks.
SugestãoSuggestion Examine o código e remova ou altere a lógica que depende de categorias de caractere Unicode embutido em código.Review code and remove/change logic that depends on hard-coded Unicode character categories.
EscopoScope SecundárioMinor
VersãoVersion 4.6.24.6.2
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

RedeNetworking

ContentDisposition DateTimes retorna cadeia de caracteres ligeiramente diferenteContentDisposition DateTimes returns slightly different string

DetalhesDetails As representações de cadeia de caracteres de ContentDisposition foram atualizadas, a partir da versão 4.6, para sempre representarem o componente de hora de um DateTime com dois dígitos.String representations of ContentDisposition's have been updated, beginning in 4.6, to always represent the hour component of a DateTime with two digits. Isso está em conformidade com a RFC822 e RFC2822.This is to comply with RFC822 and RFC2822. Isso faz com que ToString() retorne uma cadeia de caracteres ligeiramente diferente na versão 4.6 em cenários em que um dos elementos de tempo da disposição era anterior a 10:00 AM.This causes ToString() to return a slightly different string in 4.6 in scenarios where one of the disposition's time elements was before 10:00 AM. Observe que ContentDispositions, às vezes, são serializados por meio de conversão em cadeias de caracteres, de modo que quaisquer operações ToString(), serialização ou chamadas GetHashCode devem ser revisadas.Note that ContentDispositions are sometimes serialized via converting them to strings, so any ToString() operations, serialization, or GetHashCode calls should be reviewed.
SugestãoSuggestion Não espere que essas representações de cadeia de caracteres de ContentDispositions de diferentes versões do .NET Framework sejam corretamente comparadas umas com as outras.Do not expect that string representations of ContentDispositions from different .NET Framework versions will correctly compare to one another. Converta as cadeias de caracteres de volta em ContentDispositions, se possível, antes de realizar uma comparação.Convert the strings back to ContentDispositions, if possible, before conducting a comparison.
EscopoScope SecundárioMinor
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

SegurançaSecurity

RSACng.VerifyHash agora retorna False para qualquer falha de verificaçãoRSACng.VerifyHash now returns False for any verification failure

DetalhesDetails A partir do .NET Framework 4.6.2, esse método retornará False se a assinatura em si estiver incorretamente formatada.Starting with the .NET Framework 4.6.2, this method returns False if the signature itself is badly formatted. Agora, ele retornará false para qualquer falha de verificação. No .NET Framework 4.6 e 4.6.1, o método gera CryptographicException se a assinatura em si está incorretamente formatada.It now returns false for any verification failure.In the .NET Framework 4.6 and 4.6.1, the method throws a CryptographicException if the signature itself is badly formatted.
SugestãoSuggestion Qualquer código cuja execução dependa da identificação de CryptographicException deverá ser executado se a validação falhar e o método retornar False.Any code whose execution depends on handling the CryptographicException should instead execute if validation fails and the method returns False.
EscopoScope SecundárioMinor
VersionVersion 4.6.24.6.2
DigiteType RuntimeRuntime
APIs afetadasAffected APIs

Alterações de falha de SignedXml e EncryptedXmlSignedXml and EncryptedXml Breaking Changes

DetalhesDetails No .NET Framework 4.6.2, correções de segurança em SignedXml e EncryptedXml levam a comportamentos de tempo de execução diferentes.In .NET Framework 4.6.2, Security fixes in SignedXml and EncryptedXml lead to different run-time behaviors. Por exemplo,For example,
  • Se um documento tiver vários elementos com o mesmo atributo id e uma assinatura tiver como destino um desses elementos como a raiz da assinatura, o documento agora será considerado inválido.If a document has multiple elements with the same id attribute and a signature targets one of those elements as the root of the signature, the document will now be considered invalid.
  • Documentos que usam algoritmos de transformação XPath não canônicos nas referências agora são considerados inválidos.Documents using non-canonical XPath transform algorithms in references are now considered invalid.
  • Documentos que usam algoritmos de transformação XSLT não canônicos nas referências agora são considerados inválidos.Documents using non-canonical XSLT transform algorithms in references are now consider invalid.
  • Nenhum programa que usar assinaturas desanexadas de recursos externos poderá fazer isso.Any program making use of external resource detached signatures will be unable to do so.
SugestãoSuggestion Talvez os desenvolvedores queiram revisar o uso de XmlDsigXsltTransform e XmlDsigXsltTransform, bem como dos tipos derivados de Transform, uma vez que o receptor de um documento poderá não conseguir processá-lo.Developers might want to review the usage of XmlDsigXsltTransform and XmlDsigXsltTransform, as well as types derived from Transform since a document receiver may not be able to process it.
EscopoScope SecundárioMinor
VersãoVersion 4.6.24.6.2
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

SerializaçãoSerialization

A mensagem de exceção foi alterada para a falha na serialização DataContract no caso de um tipo desconhecidoException message has changed for failed DataContract serialization in case of an unknown type

DetalhesDetails A partir do .NET Framework 4.6, a mensagem de exceção gerada se a serialização ou desserialização de DataContractSerializer ou DataContractJsonSerializer falhar por causa de "tipos conhecidos" ausentes foi esclarecida.Beginning in the .NET Framework 4.6, the exception message given if a DataContractSerializer or DataContractJsonSerializer fails to serialize or deserialize due to missing 'known types' has been clarified.
SugestãoSuggestion Os aplicativos não devem depender de mensagens de exceção específicas.Apps should not depend on specific exception messages. Se um aplicativo depender dessa mensagem, atualize-o para que ele espere a nova mensagem ou, preferencialmente, altere-o para depender somente do tipo de exceção.If an app depends on this message, either update it to expect the new message or (preferably) change it to depend only on the exception type.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Instalação e ImplantaçãoSetup and Deployment

Alterações de controle de versão de produto no .NET Framework 4.6 e versões posterioresProduct versioning changes in the .NET Framework 4.6 and later versions

DetalhesDetails O controle de versão do produto foi alterado nas versões anteriores do .NET Framework, especialmente do .NET Framework 4, 4.5, 4.5.1 e 4.5.2.Product versioning has changed from the previous releases of the .NET Framework, and particularly from the .NET Framework 4, 4.5, 4.5.1, and 4.5.2. Veja a seguir as alterações em detalhes:The following are the detailed changes:
  • O valor da entrada Version na chave HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full foi alterado para 4.6.xxxxx para o .NET Framework 4.6 e suas versões pontuais, e para 4.7.xxxxx para o .NET Framework 4.7 e 4.7.1.The value of the Version entry in the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full key has changed to 4.6.xxxxx for the .NET Framework 4.6 and its point releases, and to 4.7.xxxxx for the .NET Framework 4.7 and 4.7.1. No .NET Framework 4.5, 4.5.1 e 4.5.2, ele tinha o formato 4.5.xxxxx.In the .NET Framework 4.5, 4.5.1, and 4.5.2, it had the format 4.5.xxxxx.
  • O controle de versão de arquivo e produto para arquivos do .NET Framework foi alterado do esquema de controle de versão anterior de 4.0.30319.x para 4.6.X.0 para o .NET Framework 4.6 e suas versões pontuais, e para 4.7.X.0 para o .NET Framework 4.7 e 4.7.1.The file and product versioning for .NET Framework files has changed from the earlier versioning scheme of 4.0.30319.x to 4.6.X.0 for the .NET Framework 4.6 and its point releases, and to 4.7.X.0 for the .NET Framework 4.7 and 4.7.1. Você pode ver esses novos valores quando exibe as Propriedades do arquivo depois de clicar com o botão direito do mouse em um arquivo.You can see these new values when you view the file's Properties after right-clicking on a file.
  • Os atributos AssemblyFileVersionAttribute e AssemblyInformationalVersionAttribute para assemblies gerenciados têm valores de Versão no formato 4.6.X.0 para o .NET Framework 4.6 e suas versões pontuais, e 4.7.X.0 para o .NET Framework 4.7 e 4.7.1.The AssemblyFileVersionAttribute and AssemblyInformationalVersionAttribute attributes for managed assemblies have Version values in the form 4.6.X.0 for the .NET Framework 4.6 and its point releases, and 4.7.X.0 for the .NET Framework 4.7 and 4.7.1.
  • No .NET Framework 4.6, 4.6.1, 4.6.2, 4.7 e 4.7.1, a propriedade Environment.Version retorna a cadeia de caracteres de versão fixa 4.0.30319.42000.In the .NET Framework 4.6, 4.6.1, 4.6.2, 4.7, and 4.7.1, the Environment.Version property returns the fixed version string 4.0.30319.42000. No .NET Framework 4, 4.5, 4.5.1 e 4.5.2, ela retorna as cadeias de caracteres de versão no formato 4.0.30319.xxxxx (por exemplo, "4.0.30319.18010").In the .NET Framework 4, 4.5, 4.5.1, and 4.5.2, it returns version strings in the format 4.0.30319.xxxxx (for example, "4.0.30319.18010"). Não é recomendável criar nova dependência de código de aplicativo na propriedade Environment.Version.Note that we do not recommend application code taking any new dependency on the Environment.Version property.
Para obter mais informações, confira Como: Determinar quais versões do .NET Framework estão instaladas.For more information, see How to: Determine which .NET Framework Versions Are Installed.
SugestãoSuggestion Em geral, os aplicativos devem depender das técnicas recomendadas para detecção de itens como a versão de tempo de execução do .NET Framework e o diretório de instalação:In general, applications should depend on the recommended techniques for detecting such things as the runtime version of the .NET Framework and the installation directory:
[!IMPORTANT] O nome da subchave é NET Framework Setup, e não .NET Framework Setup.The subkey name is NET Framework Setup, not .NET Framework Setup.
  • Para determinar o caminho do diretório do Common Language Runtime do .NET Framework, chame o método RuntimeEnvironment.GetRuntimeDirectory().To determine the directory path to the .NET Framework common language runtime, call the RuntimeEnvironment.GetRuntimeDirectory() method.
  • Para obter a versão do CLR, chame o método RuntimeEnvironment.GetSystemVersion().To get the CLR version, call the RuntimeEnvironment.GetSystemVersion() method. Para o .NET Framework 4 e suas versões pontuais (o .NET Framework 4.5, 4.5.1, 4.5.2 e o .NET Framework 4.6, 4.6.1, 4.6.2, 4.7 e 4.7.1), ele retorna a cadeia de caracteres v4.0.30319.For the .NET Framework 4 and its point releases (the .NET Framework 4.5, 4.5.1, 4.5.2, and .NET Framework 4.6, 4.6.1, 4.6.2, 4.7, and 4.7.1), it returns the string v4.0.30319.
EscopoScope SecundárioMinor
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime

.NET Framework 4.6 não usa uma versão 4.5.x.x ao se registrar no registroThe .NET Framework 4.6 does not use a 4.5.x.x version when registering itself in the registry

DetalhesDetails Como é de se esperar, a chave de versão definida no registro (em HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP\v4\Full) do .NET Framework 4.6 começa com "4.6", e não "4.5".As one might expect, the version key set in the registry (at HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\NET Framework Setup\NDP\v4\Full) for the .NET Framework 4.6 begins with '4.6', not '4.5'. Os aplicativos que dependem dessas chaves do Registro para saber quais versões do .NET Framework estão instaladas em um computador precisam ser atualizados para compreenderem que 4.6 é uma nova versão possível, compatível com as versões 4.5.x anteriores.Apps that depend on these registry keys to know which .NET Framework versions are installed on a machine should be updated to understand that 4.6 is a new possible version, and one that is compatible with previous 4.5.x releases.
SugestãoSuggestion Atualize os aplicativos que estão investigando uma instalação do .NET Framework 4.5 procurando por chaves do Registro 4.5 que também aceitam 4.6.Update apps probing for a .NET Framework 4.5 install by looking for 4.5 registry keys to also accept 4.6.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime

FerramentasTools

Contract.Invariant ou Contract.Requires<TException> não consideram String.IsNullOrEmpty puroContract.Invariant or Contract.Requires<TException> do not consider String.IsNullOrEmpty to be pure

DetalhesDetails Para aplicativos direcionados ao .NET Framework 4.6.1, se o contrato invariável de Contract.Invariant ou o contrato de pré-condição de Requires chamar o método String.IsNullOrEmpty, o regravador emitirá o aviso do compilador CC1036: "Chamada detectada ao método 'System.String.IsNullOrWhteSpace(System.String)' sem [Pure] no método." Esse é um aviso do compilador, e não um erro do compilador.For apps that target the .NET Framework 4.6.1, if the invariant contract for Contract.Invariant or the precondition contract for Requires calls the String.IsNullOrEmpty method, the rewriter emits compiler warning CC1036: "Detected call to method 'System.String.IsNullOrWhteSpace(System.String)' without [Pure] in method." This is a compiler warning rather than a compiler error.
SugestãoSuggestion Esse comportamento foi abordado em Problema nº 339 no GitHub.This behavior was addressed in GitHub Issue #339. Para eliminar esse aviso, você pode baixar e compilar uma versão atualizada do código-fonte para a ferramenta de Contratos de Código no GitHub.To eliminate this warning, you can download and compile an updated version of the source code for the Code Contracts tool from GitHub. As informações para download são encontradas no fim da página.Download information is found at the bottom of the page.
EscopoScope SecundárioMinor
VersãoVersion 4.6.14.6.1
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

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

Remoção de Ssl3 de TransportDefaults do WCFRemove Ssl3 from the WCF TransportDefaults

DetalhesDetails Ao usar NetTcp com segurança de transporte e um tipo de credencial de certificado, o SSL 3 não é mais um protocolo padrão usado para negociar uma conexão segura.When using NetTcp with transport security and a credential type of certificate, the SSL 3 protocol is no longer a default protocol used for negotiating a secure connection. Na maioria dos casos, não deve haver impacto nos aplicativos existentes, pois o TLS 1.0 sempre esteve incluído na lista de protocolos para NetTcp.In most cases there should be no impact to existing apps as TLS 1.0 has always been included in the protocol list for NetTcp. Todos os clientes existentes devem ser capazes de negociar uma conexão usando, no mínimo, o TLS 1.0.All existing clients should be able to negotiate a connection using at least TLS1.0.
SugestãoSuggestion Se Ssl3 for exigido, use um dos seguintes mecanismos de configuração para adicioná-lo à lista de protocolos negociados.If Ssl3 is required, use one of the following configuration mechanisms to add Ssl3 to the list of negotiated protocols.
  • SslProtocols
  • SslProtocols
  • <
  • [<sslStreamSecurity> section of <customBinding>]~/docs/framework/configure-apps/file-schema/wcf/sslstreamsecurity.md)[<sslStreamSecurity> section of <customBinding>]~/docs/framework/configure-apps/file-schema/wcf/sslstreamsecurity.md)
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.6.24.6.2
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

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árioMinor
VersãoVersion 4.7.14.7.1
TipoType Tempo de execuçãoRuntime
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árioMinor
VersãoVersion 4.7.14.7.1
TipoType Tempo de execuçãoRuntime

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árioMinor
VersãoVersion 4.7.14.7.1
TipoType Tempo de execuçãoRuntime

Serviços WCF que usam NETTCP com a segurança SSL e autenticação de certificado MD5WCF services that use NETTCP with SSL security and MD5 certificate authentication

DetalhesDetails O .NET Framework 4.6 adiciona o TLS 1.1 e o TLS 1.2 à lista padrão de protocolos SSL do WCF.The .NET Framework 4.6 adds TLS 1.1 and TLS 1.2 to the WCF SSL default protocol list. Quando os computadores cliente e servidor têm o .NET Framework 4.6 ou versões posteriores instaladas, o TLS 1.2 é usado para negociação. O TLS 1.2 não é compatível com a autenticação do certificado MD5.When both client and server machines have the .NET Framework 4.6 or later installed, TLS 1.2 is used for negotiation.TLS 1.2 does not support MD5 certificate authentication. Consequentemente, se um cliente usar um certificado MD5, o cliente WCF falhará ao se conectar ao serviço WCF.As a result, if a customer uses an MD5 certificate, the WCF client will fail to connect to the WCF service.
SugestãoSuggestion Você pode contornar esse problema para que um cliente WCF possa se conectar a um servidor WCF seguindo um destes procedimentos:You can work around this issue so that a WCF client can connect to a WCF server by doing any of the following:
  • Atualize o certificado para não usar o algoritmo MD5.Update the certificate to not use the MD5 algorithm. Esta é a solução recomendada.This is the recommended solution.
  • Se a associação não tiver sido configurada dinamicamente no código-fonte, atualize o arquivo de configuração de aplicativo para usar o TLS 1.1 ou uma versão anterior do protocolo.If the binding is not dynamically configured in source code, update the application's configuration file to use TLS 1.1 or an earlier version of the protocol. Isso permite que você continue usando um certificado com o algoritmo de hash MD5.This allows you to continue to use a certificate with the MD5 hash algorithm.
[!WARNING] Essa solução alternativa não é recomendada, pois um certificado com o algoritmo de hash MD5 é considerado inseguro.This workaround is not recommended, since a certificate with the MD5 hash algorithm is considered insecure.
O arquivo de configuração que se segue demonstra isso:The following configuration file does this:
<configuration>
<system.serviceModel>
<bindings>
<netTcpBinding>
<binding>
<security mode= "None/Transport/Message/TransportWithMessageCredential" >
<transport clientCredentialType="None/Windows/Certificate"
protectionLevel="None/Sign/EncryptAndSign"
sslProtocols="Ssl3/Tls1/Tls11">
</transport>
</security>
</binding>
</netTcpBinding>
</bindings>
</system.ServiceModel>
</configuration>
[!WARNING] Essa solução alternativa não é recomendada, pois um certificado com o algoritmo de hash MD5 é considerado inseguro.This workaround is not recommended, since a certificate with the MD5 hash algorithm is considered insecure.
EscopoScope SecundárioMinor
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime

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

Acessar os itens selecionados de um DataGrid do WPF em um manipulador do evento UnloadingRow do DataGrid pode gerar NullReferenceExceptionAccessing a WPF DataGrid's selected items from a handler of the DataGrid's UnloadingRow event can cause a NullReferenceException

DetalhesDetails Por causa de um bug no .NET Framework 4.5, os manipuladores de eventos DataGrid que envolvem a remoção de uma linha podem gerar NullReferenceException se acessarem as propriedades SelectedItem ou SelectedItems de DataGrid.Due to a bug in the .NET Framework 4.5, event handlers for DataGrid events involving the removal of a row can cause a NullReferenceException to be thrown if they access the DataGrid's SelectedItem or SelectedItems properties.
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.54.5
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Chamar Items.Refresh em uma ListBox, ListView ou DataGrid do WPF com itens selecionados pode exibir itens duplicados no elementoCalling Items.Refresh on a WPF ListBox, ListView, or DataGrid with items selected can cause duplicate items to appear in the element

DetalhesDetails No .NET Framework 4.5, chamar ListBox.Items.Refresh do código enquanto itens estiverem selecionados em uma ListBox pode fazer com que os itens selecionados sejam duplicados na lista.In the .NET Framework 4.5, calling ListBox.Items.Refresh from code while items are selected in a ListBox can cause the selected items to be duplicated in the list. Ocorre um problema semelhante com ListView e DataGrid.A similar issue occurs with ListView and DataGrid. Isso foi corrigido no .NET Framework 4.6.This is fixed in the .NET Framework 4.6.
SugestãoSuggestion Esse problema pode ser contornado de forma programática cancelando a seleção dos itens antes de chamar Refresh() e selecionando-os novamente após a conclusão da chamada.This issue may be worked around by programatically unselecting items before Refresh() is called and then re-selecting them after the call is completed. Como alternativa, esse problema foi corrigido no .NET Framework 4.6 e pode ser resolvido com o upgrade para essa versão do .NET Framework.Alternatively, 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.54.5
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

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. Nada acontecerá ou os primeiros dois níveis fecharão, dependendo de onde você clicar. Agora, esses casos (e outras variantes) funcionam conforme o 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
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Alterar a propriedade IsEnabled do pai de um controle TextBlock afeta os controles filhoChanging the IsEnabled property of the parent of a TextBlock control affects any child controls

DetalhesDetails A partir do .NET Framework 4.6.2, alterar a propriedade IsEnabled do pai de um controle TextBlock afetará os controles filho (como hiperlinks e botões) do controle TextBlock. No .NET Framework 4.6.1 e versões anteriores, os controles dentro de TextBlock nem sempre refletiam o estado da propriedade IsEnabled do pai TextBlock.Starting with the .NET Framework 4.6.2, changing the IsEnabled property of the parent of a TextBlock control affects any child controls (such as hyperlinks and buttons) of the TextBlock control.In the .NET Framework 4.6.1 and earlier versions, controls inside a TextBlock did not always reflect the state of the IsEnabled property of the TextBlock parent.
SugestãoSuggestion nenhuma.None. Essa alteração está em conformidade com o comportamento esperado para controles dentro de um controle TextBlock.This change conforms to the expected behavior for controls inside a TextBlock control.
EscopoScope SecundárioMinor
VersãoVersion 4.6.24.6.2
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Rolagem horizontal e virtualizaçãoHorizontal scrolling and virtualization

DetalhesDetails Essa alteração se aplica a um ItemsControl que faz sua própria virtualização na direção ortogonal para a direção de rolagem principal (o principal exemplo é DataGrid com EnableColumnVirtualization="True").This change applies to an ItemsControl that does its own virtualization in the direction orthogonal to the main scrolling direction (the chief example is DataGrid with EnableColumnVirtualization="True"). O resultado de certas operações de rolagem horizontal foi alterado para produzir resultados mais intuitivos e análogos aos resultados de operações verticais comparáveis.The outcome of certain horizontal scrolling operations has been changed to produce results that are more intuitive and more analogous to the results of comparable vertical operations.

As operações específicas incluem "Rolar Aqui" e "Borda Direita" para usar os nomes dos menus obtidos clicando com o botão direito do mouse em uma barra de rolagem horizontal.The operations include "Scroll Here" and "Right Edge", to use the names from the menu obtained by right-clicking a horizontal scrollbar. Ambas calculam um deslocamento candidato e chamam SetHorizontalOffset(Double).Both of these compute a candidate offset and call SetHorizontalOffset(Double).

Depois de rolar para o novo deslocamento, a definição de "aqui" ou de "borda direita" poderá mudar, pois um conteúdo com a virtualização removida recentemente alterou o valor de ExtentWidth.After scrolling to the new offset, the notion of "here" or "right edge" may have changed because newly de-virtualized content has changed the value of ExtentWidth.

Antes do .NET Framework 4.6.2, a operação de rolagem simplesmente usa o deslocamento candidato, embora ele talvez não seja mais "aqui" ou na "borda direita".Prior to .NET Framework 4.6.2, the scroll operation simply uses the candidate offset, even though it may not be "here" or at the "right edge" any more. Isso resulta em efeitos como o "salto" de rolagem, melhor ilustrado pelo exemplo.This results in effects like "bouncing" the scroll thumb, best illustrated by example. Suponha que um DataGrid tenha ExtentWidth = 1000 e Width = 200.Suppose a DataGrid has ExtentWidth=1000 and Width=200. Uma rolagem para "Borda Direita" usa o deslocamento de candidato 1000-200 = 800.A scroll to "Right Edge" uses candidate offset 1000 - 200 = 800. Durante a rolagem até esse deslocamento, a virtualização de novas colunas é eliminada. Vamos supor que elas sejam muito largas, então o ExtentWidth muda para 2000.While scrolling to that offset, new columns are de- virtualized; let's suppose they are very wide, so that the ExtentWidth changes to 2000. A rolagem termina com HorizontalOffset=800 e o elevador "retorna" para perto do meio da barra de rolagem, precisamente em 800/2000 = 40%.The scroll ends with HorizontalOffset=800, and the thumb "bounces" back to near the middle of the scrollbar - precisely at 800/2000 = 40%.

A alteração é para recalcular um novo deslocamento candidato quando essa situação ocorre e tentar novamente.The change is to recompute a new candidate offset when this situation occurs, and try again. (A rolagem vertical já funciona assim.)(This is how vertical scrolling works already.)

A alteração proporciona uma experiência mais previsível e intuitiva para o usuário final, mas também pode afetar qualquer aplicativo que dependa do valor exato de HorizontalOffset após uma rolagem horizontal, seja ela invocada pelo usuário final ou por uma chamada explícita para SetHorizontalOffset(Double).The change produces a more predictable and intuitive experience for the end user, but it could also affect any app that depends on the exact value of HorizontalOffset after a horizontal scroll, whether invoked by the end user or by an explicit call to SetHorizontalOffset(Double).

SugestãoSuggestion Um aplicativo que usa um valor previsto para HorizontalOffset deve ser alterado para obter o valor real (e o valor de ExtentWidth) após qualquer rolagem horizontal que poderia alterar ExtentWidth devido à eliminação da virtualização.An app that uses a predicted value for HorizontalOffset should be changed to fetch the actual value (and the value of ExtentWidth) after any horizontal scroll that could change ExtentWidth due to de-virtualization.
EscopoScope SecundárioMinor
VersãoVersion 4.6.24.6.2
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Items.Clear não remove duplicatas de SelectedItemsItems.Clear does not remove duplicates from SelectedItems

DetalhesDetails Suponha que um Seletor (com seleção múltipla habilitada) tenha duplicatas em sua coleção SelectedItems – o mesmo item é exibido mais de uma vez.Suppose a Selector (with multiple selection enabled) has duplicates in its SelectedItems collection - the same item appears more than once. A remoção desses itens da fonte de dados (por exemplo, chamando Items.Clear) falha ao removê-los de SelectedItems; somente a primeira instância é removida.Removing those items from the data source (e.g. by calling Items.Clear) fails to remove them from SelectedItems; only the first instance is removed. Além disso, o uso subsequente de SelectedItems (por exemplo, SelectedItems.Clear()) pode encontrar problemas, como ArgumentException, pois SelectedItems contém itens que não estão mais na fonte de dados.Furthermore, subsequent use of SelectedItems (e.g. SelectedItems.Clear()) can encounter problems such as ArgumentException, because SelectedItems contains items that are no longer in the data source.
SugestãoSuggestion Atualize se possível para o .NET Framework 4.6.2.Upgrade if possible to .NET Framework 4.6.2.
EscopoScope SecundárioMinor
VersãoVersion 4.54.5
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Problema de associação de ListBoxItem IsSelected com ObservableCollection<T>.MoveListBoxItem IsSelected binding issue with ObservableCollection<T>.Move

DetalhesDetails Chamar Move(Int32, Int32) ou MoveItem(Int32, Int32) em uma coleção associada a um ListBox com itens selecionados pode gerar comportamento imprevisível em seleções ou cancelamentos de seleção futuros de itens ListBox.Calling Move(Int32, Int32) or MoveItem(Int32, Int32) on a collection bound to a ListBox with items selected can lead to erratic behavior with future selection or unselection of ListBox items.
SugestãoSuggestion Chamar Remove(T) e Insert(Int32, T) em vez de Move(Int32, Int32) é uma solução alternativa para esse problema.Calling Remove(T) and Insert(Int32, T) instead of Move(Int32, Int32) will work around this issue. Como alternativa, esse problema foi corrigido no .NET Framework 4.6 e pode ser resolvido com o upgrade para essa versão do .NET Framework.Alternatively, 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.54.5
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

Clicar com o botão direito do mouse em um cabeçalho de linha do DataGrid do WPF altera a seleção de DataGridRight clicking on a WPF DataGrid row header changes the DataGrid selection

DetalhesDetails Clicar com o botão direito do mouse em um cabeçalho de linha DataGrid enquanto várias linhas estão selecionadas altera a seleção de DataGrid para somente a linha em questão.Right-clicking a selected DataGrid row header while multiple rows are selected results in the DataGrid's selection changing to only that row.
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 Microsoft EdgeEdge
VersãoVersion 4.54.5
TipoType Tempo de execuçãoRuntime
APIs afetadasAffected APIs

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
TipoType Tempo de execuçãoRuntime

WPF gera um processo wisptis.exe que pode congelar o mouseWPF spawns a wisptis.exe process which can freeze the mouse

DetalhesDetails Um problema foi introduzido na versão 4.5.2 que faz com que wisptis.exe seja gerado e possa congelar a entrada do mouse.An issue was introduced in 4.5.2 that causes wisptis.exe to be spawned that can freeze mouse input.
SugestãoSuggestion A correção desse problema está disponível em uma versão de serviço do .NET Framework 4.5.2 (hotfix de rollup 3026376) ou por meio da atualização para o .NET Framework 4.6.A fix for this issue is available in a servicing release of the .NET Framework 4.5.2 (hotfix rollup 3026376), or by upgrading to the .NET Framework 4.6
EscopoScope PrincipalMajor
VersãoVersion 4.5.24.5.2
TipoType Tempo de execuçãoRuntime

Verificação ortográfica do WPF em controles habilitados por texto não funcionará no Windows 10 para idiomas que não estão na lista de idiomas de entrada do sistema operacionalWPF spell checking in text-enabled controls will not work in Windows 10 for languages not in the OS's input language list

DetalhesDetails Ao ser executado no Windows 10, o verificador ortográfico pode não funcionar em controles habilitados por texto do WPF, pois as funcionalidades da plataforma de verificação ortográfica estão disponíveis somente para os idiomas presentes na lista de idiomas de entrada. No Windows 10, quando um idioma é adicionado à lista de teclados disponíveis, o Windows baixa e instala automaticamente um pacote FOD (Recurso sob Demanda) que oferece as funcionalidades de verificação ortográfica.When running on Windows 10, the spell checker may not work for WPF text-enabled controls because platform spell-checking capabilities are available only for languages present in the input languages list.In Windows 10, when a language is added to the list of available keyboards, Windows automatically downloads and installs a corresponding Feature on Demand (FOD) package that provides spell-checking capabilities. Ao adicionar o idioma à lista de idiomas de entrada, o verificador ortográfico terá suporte.By adding the language to the input languages list, the spell checker will be supported.
SugestãoSuggestion Lembre-se de que o idioma ou texto a ser verificado ortograficamente precisa ser adicionado como idioma de entrada para a verificação ortográfica funcionar no Windows 10.Be aware that the language or text to be spell-checked must be added as an input language for spell-checking to work in Windows 10.
EscopoScope Microsoft EdgeEdge
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime

Janelas do WPF são renderizadas sem distorção ao se estender para fora de um único monitorWPF windows are rendered without clipping when extending outside a single monitor

DetalhesDetails No .NET Framework 4.6 em execução no Windows 8 e superior, a janela inteira é renderizada sem distorção quando ela se estende para fora da exibição única em um cenário de vários monitores.In the .NET Framework 4.6 running on Windows 8 and above, the entire window is rendered without clipping when it extends outside of single display in a multi-monitor scenario. Isso é diferente de versões anteriores do .NET Framework, que distorceriam janelas do WPF que se estendiam para fora de uma única exibição.This is different from previous versions of the .NET Framework which would clip WPF windows that extended beyond a single display.
SugestãoSuggestion Esse comportamento (com distorção ou não) pode ser definido explicitamente usando o elemento <EnableMultiMonitorDisplayClipping> em <appSettings> no arquivo de configuração do aplicativo ou definindo a propriedade EnableMultiMonitorDisplayClipping durante a inicialização do aplicativo.This behavior (whether to clip or not) can be explicitly set using the <EnableMultiMonitorDisplayClipping> element in <appSettings> in an application's configuration file, or by setting the EnableMultiMonitorDisplayClipping property at app startup.
EscopoScope SecundárioMinor
VersãoVersion 4.64.6
TipoType Tempo de execuçãoRuntime

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 tempo de execução 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árioMinor
VersãoVersion 4.74.7
TipoType Tempo de execuçãoRuntime
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
TipoType Tempo de execuçãoRuntime