C# Visual Studio Debugging

Target

Debugging. The values of local variables change as a program executes. It is possible to see these changes. This is useful for when you want to make sure the values are correct.


Debug menu

Visual Studio. You can debug your variables in the Visual Studio integrated development environment. This is a short tutorial. In it, we deal with local variables.


The C# programming language

A program. First here we look at a short program that has several local variables in it. To look inside your locals, you need to set a breakpoint somewhere in the code.

First:Please start up your version of Visual Studio and create a new C# console application.

Program that uses local variables: C#

using System;

class Program
{
    static void Main()
    {
	// A.
	// An integer is local.
	int cat = 1;

	// B.
	// A string is local.
	string dog = "cute";

	// C.
	// An array is local.
	bool[] b = new bool[]
	{
	    true,
	    false,
	    true,
	    true
	};
    }
}

Screenshot of breakpoint in Visual Studio

Debugging breakpoint. Here we add a breakpoint near the end of the above program. On the far left of your source code tab, you will see a narrow gray strip.

Then:Click on it in the line you want to debug. The red circle on the left is where you need to click to set the debugging breakpoint.

And:The red block over the code line is where the debugger will open. We must first execute the program.


Target

Point hit. When you set the breakpoint red circle on your code, the debugger will open only if that point is hit. So breakpoints can alert you if something unexpected happens.


Start

Start debugging. You can initialize the debugger at the same time as starting your program in Visual Studio. To do this, click on the green arrow in your Visual Studio toolbar.

And:The icons on your setup will look a little different depending on your preferences and OS.


Locals window in Visual Studio

The breakpoint will be hit as the program executes. The red blocks will turn yellow and you may see different panes such as the Call Stack pane.

Next:Open the Locals window. You can open the Locals pane in more than one way. Go to Debug -> Windows -> Locals.


List

Locals. Here we look at some features in the Visual Studio IDE related to local variable debugging. You can browse hierarchies of the locals' internals.

Note:Many of these options are advanced and not needed for most debugging purposes.

Properties in debugger: Visual Studio

Name:
The name of your variable.

Value:
The data stored in your variable.

Type:
The data type of your variable, such as int, string, bool[].

Text Visualizer:
Allows you to see the plain text value in the variable.

XML Visualizer:
For XML files. You can visualize XML data with this function.

HTML Visualizer:
Use to view the data in Internet Explorer as HTML.

Expression:
This is on the Visualizer windows. Shows the variable name.

Step over. Let's look at step options. Often when debugging, you want to advance one step. Clicking the green arrow in the toolbar to Continue will take you to the next breakpoint.

Note:Using these options takes practice. It is hard to learn them at the same time you are learning an entire language.

Step options: Visual Studio

Step Into, F11:
Use Step Into to go inside your method and stop immediately inside it.

Step Over:
This also moves to the next step in your code.
It doesn't, however, break inside any methods.

Step Out:
Ignores the rest of the current method and goes to the calling method.

ABC: letters

Step example. In our example, we want to use Step Over. This will enable us to see the values of all of the variables. The final variable is assigned at the end of the method.


Locals: array

Arrays. Here we examine the array type as it appears during execution in the Visual Studio debugger. This is an effective way to monitor the values of elements in an array during runtime.

Note:The screenshot shows the local arrays. Each element in the array is referenced by an index.

Tip:Look inside an array by clicking on the + box. You can browse all elements.

Array elements

- b              - name of the array
    [0] true     - first value in array
    [1] false    - second value in array
    [2] true     - third
    [3] true     - fourth

About part

Options. The debugger has many more options, including Call Stack, Command Window, Exceptions, and Autos. You can configure breakpoints.

And:With break points, we can write messages to the console, or keep counts of how many times they are hit.

Activation Record
Squares: abstract

Disable debugger. Before you ever deploy your web site or Windows Forms application, disable debugging. This will eliminate the features in this article but you can re-enable it later.

Method 1:In your ASP.NET website, open Web.config and change the compilation tag's debug attribute to false.

Method 2:In Windows applications, go to Project -> MyApplication Properties... Then change the Configure dropdown to Release.

Method 3:The third way is to change the toolbar dropdown when it is available.


Overhead. The debugger causes significant performance overhead. In my experience it takes close to twice the time to execute Debug programs.

And:This depends on the program. More complex, algorithmic programs tend to become still slower.

Benchmark:For benchmarking, please run outside of the debugger. For the best benchmarks, do not involve Visual Studio at all.

Benchmark

Edit value. We can use the "Edit Value" feature to change the value of a variable in a program as it runs. Try this. On the second if-statement, add a breakpoint.

Then:When the breakpoint is hit, right click on its value in the Locals window. And change its value to 3.

Result:The value "true" will be printed twice.
We edited the value to be 2 and then 3.

Program for Edit Value demonstration: C#

using System;

class Program
{
    static void Main()
    {
	int value = 2;
	if (value == 2)
	{
	    Console.WriteLine(true);
	}
	if (value == 3)
	{
	    Console.WriteLine(true);
	}
    }
}

Output

true
true

Print

Console. Other methods are available to you for debugging complex or simple programs. If you are using a console program, the Console.WriteLine method (or Console.Write) are useful.

Note:This doesn't involve the VS debugging environment. So they can be used when testing release builds and for performance testing.

Console.WriteLine
Framework: NET

Debug methods. The .NET Framework provides methods in the Debug class that can be used to hard-code debugging facilities. Some methods that you can use are Debug.Write and Debug.Assert.

Tip:The benefit to these methods over the Console methods is that they are removed in Release builds of your application.

Debug.Write
About part

A summary. We looked inside the variables in methods using the Visual Studio debugger. Local variables are part of every program, and writing them out with Console.Write is cumbersome.


Concept

With the debugger, we eliminate lots of manual work. In the C language, programmers use "printf" statements, which are like Console.Write. But using Locals in the debugger is easier.


As time passes, I update this tutorial. I created it originally for Visual Studio 2008. But this current version targets Visual Studio 2013.


C#: .NET: VS