dotnet/Documentation/compatibility/webutility_htmlencode-and-webutility_htmldecode-round-trip-bmp-correctly.md

WebUtility.HtmlEncode and WebUtility.HtmlDecode round-trip BMP correctly

Scope

Edge

Version Introduced

4.5

Source Analyzer Status

Planned

Change Description

For applications that target the .NET Framework 4.5, characters that are outside the Basic Multilingual Plane (BMP) round-trip correctly when they are passed to the xref:System.Net.WebUtility.HtmlDecode(System.String) methods.

• Quirked
• Build-time break

Recommended Action

This change should have no effect on current applications, but to restore the original behavior, set the targetFramework attribute of the <httpRuntime> element to a string other than "4.5". You can also set the unicodeEncodingConformance and unicodeDecodingConformance attributes of the <webUtility> configuration element to control this behavior independently of the targeted version of the .NET Framework.

Affected APIs

• M:System.Net.WebUtility.HtmlEncode(System.String)
• M:System.Net.WebUtility.HtmlEncode(System.String,System.IO.TextWriter)

Category

ASP.NET