daohualiuxiang
/
dotnet
mirror of https://github.com/microsoft/dotnet.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Add Stack Trace portable PDB re-targeting guidance (#706) 

* Add Stack Trace portable PDB re-targeting guidance

* Address PR comments
pull/707/head
Chris Sienkiewicz 2018-04-10 15:54:58 -07:00 committed by Ron Petrusha
parent e8d0ad4e22
commit b284188993
1 changed files with 51 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
Documentation/compatibility/Stack-traces-obtained-when-using-portable-PDBs-now-include-source-file-and-line-information-if-requested.md 100644
View File

@ -0,0 +1,51 @@
## Stack traces obtained when using portable PDBs now include source file and line information if requested
### Scope
Edge
### Version Introduced
4.7.2
### Source Analyzer Status
NotPlanned
### Change Description
Starting with .NET Framework 4.7.2, stack traces obtained when using portable PDBs include source file and line information when requested. In versions prior to .NET Framework 4.7.2, source file and line information would be unavailable when using portable PDBs even if explicitly requested.
- [x] Quirked
- [ ] Build-time break
### Recommended Action
For applications that target the .NET Framework 4.7.2, you can opt out of the source file and line information when using portable PDBs if it is not desirable by adding the following to the `<runtime>` section of your `app.config` file:
```xml
<runtime>
<AppContextSwitchOverrides value="Switch.System.Diagnostics.IgnorePortablePDBsInStackTraces=true" />
</runtime>
```
For applications that target earlier versions of the .NET Framework but run on the .NET Framework 4.7.2 or later, you can opt in to the source file and line information when using portable PDBs by adding the following to the `<runtime>` section of your `app.config` file:
```xml
<runtime>
<AppContextSwitchOverrides value="Switch.System.Diagnostics.IgnorePortablePDBsInStackTraces=false" />
</runtime>
```
### Affected APIs
* `M:System.Diagnostics.StrackTrace.#ctor(System.Boolean)`
* `M:System.Diagnostics.StrackTrace.#ctor(System.Exception,System.Boolean)`
* `M:System.Diagnostics.StrackTrace.#ctor(System.Exception,System.Int32,System.Boolean)`
### Category
Core
[More information]([https://github.com/dotnet/core/blob/master/Documentation/diagnostics/portable_pdb.md])
<!--
Bug #534785
-->