Introduction

In this post, I'll show you how to configure your Visual Studio 2010 to step into the source code of .NET Framework 4.0.

Why?

Because it's cool.

Because it helps with debugging. 
Not only can you see the code, but you can also step into it.

Because unlike with Reflector, you get the code with the original comments and variable names!

Step 1: Download Source

Go to http://referencesource.microsoft.com/netframework.aspx.

Download from the line marked with Product Name: .NET, Version: 4. 
That's a 175MB download.

image

Step 2: Install Source

Install “Net_4.msi”, which you have downloaded in the previous step.

I've installed it into: “D:\RefSrc\”. 
The installed size is approximately 1GB of source and symbols (are you excited yet?)

image

Step 3: Setup Visual Studio 2010

For configuring Visual Studio 2010:

  1. Launch Visual Studio 2010.
  2. From the Tools menu, choose Options.
  3. In the Options dialog box, open the Debugging node and select General
    • Uncheck "Enable Just My Code (Managed only)"
    • Check "Enable source server support"
    • Uncheck "Require source files to exactly match the original version"
    • Optional: Uncheck “Step over properties and operators (Managed only)”

image

  1. Select Symbols under Debugging.

    In the Symbol File Locations box, add the downloaded symbols location: 
    “D:\RefSrc\Symbols”.
    Note: To add the Symbols path, click on the folder icon.

    Enter in text box under 'Cache symbols in this directory’: 
    “D:\RefSrc\Symbols\Cache”.

image

That’s it, you can now try to F11 (Step Into) .NET source code.

Troubleshooting

If you fail to see the symbols, try one of the following:

  • Make sure you debug a program under .NET Framework 4.0.

image

  • Make sure you didn't install it into \Program Files\, since you need elevated permissions to write to there. If you already installed it there, you can either run Visual Studio 2010 as Administrator or just change the cache folder to some other writable folder.
  • While running, Right Click on the Call Stack, on some grayed .NET functions, select “Load Symbols From” and then “Symbol Path”.

image

  • If you encounter the “No Source Available” screen, try to press “Browse to Find Source” and find the file you need in the source directory. You should probably need to use files search to find it. 
    This is done only once, since from now on Visual Studio remembers this location and searches there for missing source files.

image

Finally, you can find more information at http://referencesource.microsoft.com/.

That’s it for now, 
Arik Poznanski
.