52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
|
## Long path support
|
||
|
|
|
||
|
|
### Scope
|
||
|
|
Minor
|
||
|
|
|
||
|
|
### Version Introduced
|
||
|
|
4.6.2
|
||
|
|
|
||
|
|
### Source Analyzer Status
|
||
|
|
Investigating
|
||
|
|
|
||
|
|
### Change Description
|
||
|
|
Starting with apps that target the .NET Framework 4.6.2, long paths (of up to 32K characters) are supported, and the 260-character (or `MAX_PATH`) limitation on path lengths has been removed.
|
||
|
|
|
||
|
|
For apps that are recompiled to target the .NET Framework 4.6.2, code paths that previously threw a `T:System.IO.PathTooLongException` because a path exceeded 260 characters will now throw a `T:System.IO.PathTooLongException` only under the following conditions:
|
||
|
|
|
||
|
|
- The length of the path is greater than `F:System.Int16.MaxValue` (32,767) characters.
|
||
|
|
- The operating system returns `COR_E_PATHTOOLONG` or its equivalent.
|
||
|
|
|
||
|
|
For apps that target the .NET Framework 4.6.1 and earlier versions, the runtime automatically throws a `T:System.IO.PathTooLongException` whenever a path exceeds 260 characters.
|
||
|
|
|
||
|
|
- [X] Quirked
|
||
|
|
- [ ] Build-time break
|
||
|
|
|
||
|
|
### Recommended Action
|
||
|
|
For apps that target the .NET Framework 4.6.2, you can opt out of long path support if it is not desirable by adding the following to to the `<runtime>` section of your `app.config` file:
|
||
|
|
|
||
|
|
```xml
|
||
|
|
<runtime>
|
||
|
|
<AppContextSwitchOverrides value="Switch.System.IO.BlockLongPaths=true" />
|
||
|
|
</runtime>
|
||
|
|
```
|
||
|
|
For apps that target earlier versions of the .NET Framework but run on the .NET Framework 4.6.2 or later, you can opt in to long path support by adding the following to to the `<runtime>` section of your `app.config` file:
|
||
|
|
|
||
|
|
```xml
|
||
|
|
<runtime>
|
||
|
|
<AppContextSwitchOverrides value="Switch.System.IO.BlockLongPaths=false" />
|
||
|
|
</runtime>
|
||
|
|
```
|
||
|
|
### Affected APIs
|
||
|
|
* Not detectable via API analysis
|
||
|
|
|
||
|
|
### Category
|
||
|
|
Core
|
||
|
|
|
||
|
|
<!--
|
||
|
|
### Original Bug
|
||
|
|
195340
|
||
|
|
-->
|
||
|
|
|
||
|
|
<!-- breaking change id: 162 -->
|