4.6.x.md

title	description	ms.date	author
Retargeting changes for migration to .NET Framework 4.6.x	Find information about application compatibility issues that might affect your app when migrating to .NET Framework 4.6.x.	07/31/2023	chlowell

Retargeting changes for migration to .NET Framework 4.6.x

This article lists the app compatibility issues that were introduced in .NET Framework 4.6, 4.6.1, and 4.6.2.

.NET Framework 4.6

ASP.NET

[!INCLUDEHtmlTextWriter does not render <br/> element correctly]

ClickOnce

[!INCLUDEApps published with ClickOnce that use a SHA-256 code-signing certificate may fail on Windows 2003]

[!INCLUDEClickOnce supports SHA-256 on 4.0-targeted apps]

Core

[!INCLUDECurrentCulture and CurrentUICulture flow across tasks]

[!INCLUDEETW event names cannot differ only by a "Start" or "Stop" suffix]

Entity Framework

[!INCLUDEBuilding an Entity Framework edmx with Visual Studio 2013 can fail with error MSB4062 if using the EntityDeploySplit or EntityClean tasks]

JIT

[!INCLUDEIL ret not allowed in a try region]

[!INCLUDENew 64-bit JIT compiler in the .NET Framework 4.6]

Networking

[!INCLUDECertificate EKU OID validation]

[!INCLUDEOnly Tls 1.0, 1.1 and 1.2 protocols supported in System.Net.ServicePointManager and System.Net.Security.SslStream]

[!INCLUDETLS 1.x by default passes the SCH_SEND_AUX_RECORD flag to the underlying SCHANNEL API]

Windows Communication Foundation (WCF)

[!INCLUDECalling CreateDefaultAuthorizationContext with a null argument has changed]

Windows Forms

[!INCLUDEIcon.ToBitmap successfully converts icons with PNG frames into Bitmap objects]

Windows Presentation Foundation (WPF)

[!INCLUDECurrentCulture is not preserved across WPF Dispatcher operations]

[!INCLUDEWPF layout rounding of margins has changed]

XML, XSLT

[!INCLUDEXmlWriter throws on invalid surrogate pairs]

[!INCLUDEXSD Schema validation now correctly detects violations of unique constraints if compound keys are used and one key is empty]

.NET Framework 4.6.1

Core

[!INCLUDEChange in path separator character in FullName property of ZipArchiveEntry objects]

Windows Communication Foundation (WCF)

[!INCLUDEWCF binding with the TransportWithMessageCredential security mode]

[!INCLUDEX509CertificateClaimSet.FindClaims Considers All claimTypes]

Windows Forms

[!INCLUDEApplication.FilterMessage no longer throws for re-entrant implementations of IMessageFilter.PreFilterMessage]

Windows Presentation Foundation (WPF)

[!INCLUDECalls to System.Windows.Input.PenContext.Disable on touch-enabled systems may throw an ArgumentException]

.NET Framework 4.6.2

ASP.NET

[!INCLUDEHttpRuntime.AppDomainAppPath Throws a NullReferenceException]

Core

[!INCLUDEAesCryptoServiceProvider decryptor provides a reusable transform]

[!INCLUDECalls to ClaimsIdentity constructors]

[!INCLUDEChanges in path normalization]

[!INCLUDECurrentCulture and CurrentUICulture flow across tasks]

[!INCLUDEETW event names cannot differ only by a "Start" or "Stop" suffix]

[!INCLUDELong path support]

[!INCLUDEPath colon checks are stricter]

Security

[!INCLUDERSACng now correctly loads RSA keys of non-standard key size]

[!INCLUDESignedXml.GetPublicKey returns RSACng on net462 (or lightup) without retargeting change]

Windows Communication Foundation (WCF)

[!INCLUDEDeadlock may result when using Reentrant services]

[!INCLUDEOperationContext.Current may return null when called in a using clause]

[!INCLUDEWCF transport security supports certificates stored using CNG]

Windows Forms

[!INCLUDEIncorrect implementation of MemberDescriptor.Equals]

Windows Presentation Foundation (WPF)

[!INCLUDECurrentCulture is not preserved across WPF Dispatcher operations]