Decompiler

Use sources from symbol files when available

Select this checkbox to use debug information (PDB files) to find appropriate source files and use them to display and navigate the code.

If this checkbox is selected and the source files are available via the debug information, dotPeek displays and navigates to the original source code (for portable PDBs, embedded sources can be used).

If this checkbox is cleared or if source files are not available, dotPeek decompiles the code .

tip

You can always force to display either the decompiled or source code (if it is available via PDB files or from symbol servers). To do so, right-click an item in the Assembly Explorer window and choose Decompiled Sources or Sources from Symbol Files.

Allow downloading from remote locations

Select this checkbox to enable downloading sources from Symbol Server or other remote locations. If symbol files are available both locally and remotely, dotPeek will display local symbol files.

note

Your computer should be connected to the Internet for this option to work. If you use a proxy server, check if the corresponding option is configured correctly on the Environment | Web Proxy Settings page of dotPeek options Ctrl+Alt+S.

Enable private Source Link support

If this checkbox is selected, you will be able to navigate to the external sources that require connection to a private source server, for example Azure or GitHub Enterprise.

In some cases, dotPeek will retrieve your connection credentials automatically, for example from Git Credential Manager. If this is not possible, it will ask for the authentication details when you first navigate using specific server.

Advanced symbols options

Opens the Advanced symbols options dialog to create or edit folder substitution rules.

If an external library was compiled with another computer, then paths inside PDB files may be relative to that computer, and therefore these paths could not be resolved automatically.

To fix this, you need to add folder substitutions rules for each path. Each folder substitution rule contains two paths:

• Source Folder — a folder specified in the PDB files.

• Target Folder — a folder with relevant source files on your computer or a corresponding URL of a remote server.

Show XML documentation in decompiled sources

Select this checkbox to display XML comments in the decompiled code. The comments are only available if the XML documentation file option was enabled to build the assembly. The XML documentation is normally stored in the [AssemblyName].xml file next to the assembly file.

Show compiler-generated code

Select this checkbox to see compiler-generated code in the decompiled files. This option is an alternative to using the Show compiler-generated code button on the toolbar. For more information, see View compiler-generated code.

Show token values

Select this checkbox to display metadata token values in Assembly Explorer window and code viewer. For more information, see View metadata tokens.

Show IL code in comments

Select this checkbox to display comments with IL code corresponding to the decompiled code in the code viewer. For more information, see View intermediate language (IL).

Decompile very long methods

When this option is disabled, dotPeek will not decompile methods that contain more than 50 000 instructions. Such methods are normally auto-generated and do not present any interest, but decompiling such methods will increase decompilation time. Such methods will be displayed with a single comment // ISSUE The method is too long to display (N instructions).