dotnet/Documentation/compatibility/ASPNET-accessibility-improvement.md

## ASP.NET Accessibility Improvements in .NET Framework 4.7.1

### Scope
Minor


### Version Introduced
4.7.1


### Source Analyzer Status
NotPlanned


### Change Description
Starting with the .NET Framework 4.7.1, ASP.NET has improved how ASP.NET Web Controls work with accessibility technology in Visual Studio to better support ASP.NET customers.  These include the following changes:

- Changes to implement missing UI accessibility patterns in controls, like the Add Field dialog in the Details View wizard, or the Configure ListView dialog of the ListView wizard.

- Changes to improve the display in High Contrast mode, like the Data Pager Fields Editor.

- Changes to improve the keyboard navigation experiences for controls, like the Fields dialog in the Edit Pager Fields wizard of the DataPager control, the Configure ObjectContext dialog, or the Configure Data Selction dialog of the Configure Data Source wizard.

- [x] Quirked
- [ ] Build-time break


### Recommended Action

**How to opt in or out of these changes** 
  
In order for the Visual Studio Designer to benefit from these changes, it must run on the .NET Framework 4.7.1 or later. The web application can benefit from these changes in either of the following ways:

- Install Visual Studio 2017 15.3 or later, which supports the new accessibility features with the following AppContext Switch by default.

- Opt out of the legacy accessibility behaviors by adding the `Switch.UseLegacyAccessibilityFeatures` AppContext switch to the `<runtime>` section in the devenv.exe.config file and setting it to `false`, as the following example shows.

```xml
<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <runtime>
    ...
    <!-- AppContextSwitchOverrides value attribute is in the form of `key1=true|false;key2=true|false`  -->
    <AppContextSwitchOverrides value="Switch.UseLegacyAccessibilityFeatures=false" />
    ...
  </runtime>
</configuration>
```

Applications that target the .NET Framework 4.7.1 or later and want to preserve the legacy accessibility behavior can opt in to the use of legacy accessibility features by explicitly setting this AppContext switch to ```true```.

### Affected APIs
 * Not detectable via API analysis

### Category
ASP.NET