Welcome to the Visual Studio IDE | C#

Applies to: Visual Studio Visual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

An integrated development environment (IDE) is a feature-rich program that supports many aspects of software development. The Visual Studio IDE is a creative launching pad that you can use to edit, debug, and build code, and then publish an app. Over and above the standard editor and debugger that most IDEs provide, Visual Studio includes compilers, code completion tools, graphical designers, and many more features to enhance the software development process.

The preceding image shows Visual Studio with an open project that shows key windows and their functionality:

• In Solution Explorer, at upper right, you can view, navigate, and manage your code files. Solution Explorer can help organize your code by grouping the files into solutions and projects.

• The central editor window, where you'll probably spend most of your time, displays file contents. In the editor window, you can edit code or design a user interface such as a window with buttons and text boxes.

• The Output window (bottom center) is where Visual Studio sends notifications such as debugging and error messages, compiler warnings, publishing status messages, and more. Each message source has its own tab.

• In Git Changes at lower right, you can track work items and share code with others by using version control technologies like Git and GitHub.

Editions

Visual Studio is available for Windows and Mac. Visual Studio for Mac has many of the same features as Visual Studio for Windows, and is optimized for developing cross-platform and mobile apps. This article focuses on the Windows version of Visual Studio.

There are three editions of Visual Studio: Community, Professional, and Enterprise. See Compare Visual Studio editions to learn about which features are supported in each edition.

Popular productivity features

Some popular features in Visual Studio that improve your productivity when developing software include:

• Squiggles and Quick Actions

  Squiggles are wavy underlines that alert you to errors or potential problems in your code as you type. These visual clues help you fix problems immediately, without waiting to discover errors during build or runtime. If you hover over a squiggle, you see more information about the error. A lightbulb might also appear in the left margin showing Quick Actions you can take to fix the error.

• Refactoring

  Refactoring includes operations such as intelligent renaming of variables, extracting one or more lines of code into a new method, and changing the order of method parameters.

• IntelliSense

  IntelliSense is a set of features that display information about your code directly in the editor and, in some cases, write small bits of code for you. It's like having basic documentation inline in the editor, so you don't have to look up type information elsewhere.

  The following illustration shows how IntelliSense displays a member list for a type:

  IntelliSense features vary by language. For more information, see C# IntelliSense, Visual C++ IntelliSense, JavaScript IntelliSense, and Visual Basic IntelliSense.

• Visual Studio search

  Visual Studio menus, options, and properties can seem overwhelming at times. Visual Studio search, or Ctrl+Q, is a great way to rapidly find IDE features and code in one place.

  

  For more information, see Quick Launch.

• Live Share

  Collaboratively edit and debug with others in real time, regardless of your app type or programming language. You can instantly and securely share your project. You can also share debugging sessions, terminal instances, localhost web apps, voice calls, and more.

• Call Hierarchy

  The Call Hierarchy window shows the methods that call a selected method. This information can be useful when you're thinking about changing or removing the method, or when you're trying to track down a bug.

• CodeLens

  CodeLens helps you find code references, code changes, linked bugs, work items, code reviews, and unit tests, without leaving the editor.

• Go To Definition

  The Go To Definition feature takes you directly to the location of a function or type definition.

• Peek Definition

  The Peek Definition window shows a method or type definition without opening a separate file.

Install Visual Studio

In this section, you create a simple project to try out some of the things you can do with Visual Studio. You use IntelliSense as a coding aid, debug an app to see a variable value during app execution, and change the color theme.

To get started, download Visual Studio and install it on your system. The modular installer enables you to choose and install workloads, which are groups of features needed for the programming language or platform you prefer. To follow the steps for creating a program, be sure to select the .NET Core cross-platform development workload during installation.

When you open Visual Studio for the first time, you can sign in by using your Microsoft account or your work or school account.

Create a program

Dive in and create a simple program.

1. Open Visual Studio.

2. On the menu bar, choose File > New > Project.

   

   The New Project dialog box shows several project templates. A template contains the basic files and settings needed for a given project type.

3. Choose the .NET Core template category under Visual C#, and then choose the Console App (.NET Core) template. In the Name text box, type HelloWorld, and then select the OK button.

   

   Note

   If you don't see the .NET Core category, you need to install the .NET Core cross-platform development workload. To do this, choose the Open Visual Studio Installer link on the bottom left of the New Project dialog. After Visual Studio Installer opens, scroll down and select the .NET Core cross-platform development workload, and then select Modify.

   Visual Studio creates the project. It's a simple "Hello World" application that calls the Console.WriteLine() method to display the literal string "Hello World!" in the console (program output) window.

   Shortly, you should see something like the following screen:

   

   The C# code for your application shows in the editor window, which takes up most of the space. Notice that the text is automatically colorized to indicate different parts of the code, such as keywords and types. In addition, small, vertical dashed lines in the code indicate which braces match one another, and line numbers help you locate code later. You can choose the small, boxed minus signs to collapse or expand blocks of code. This code outlining feature lets you hide code you don't need, helping to minimize onscreen clutter. The project files are listed on the right side in a window called Solution Explorer.

   

   There are other menus and tool windows available, but let's move on for now.

4. Now, start the app. You can do this by choosing Start Without Debugging from the Debug menu on the menu bar. You can also press Ctrl+F5.

   

   Visual Studio builds the app, and a console window opens with the message Hello World!. You now have a running app!

   

5. To close the console window, press any key on your keyboard.

6. Let's add some more code to the app. Add the following C# code before the line that says Console.WriteLine("Hello World!");:

   Console.WriteLine("\nWhat is your name?");
   var name = Console.ReadLine();
   

   This code displays What is your name? in the console window, and then waits until the user enters some text followed by the Enter key.

7. Change the line that says Console.WriteLine("Hello World!"); to the following code:

   Console.WriteLine($"\nHello {name}!");
   

8. Run the app again by selecting Debug > Start Without Debugging or by pressing Ctrl+F5.

   Visual Studio rebuilds the app, and a console window opens and prompts you for your name.

9. Enter your name in the console window and press Enter.

   

10. Press any key to close the console window and stop the running program.

Use refactoring and IntelliSense

Let's look at a couple of the ways that refactoring and IntelliSense can help you code more efficiently.

First, rename the name variable:

1. Double-click the name variable, and type the new name for the variable, username.

   A box appears around the variable, and a light bulb appears in the margin.

2. Select the light bulb icon to show the available Quick Actions. Select Rename 'name' to 'username'.

   

   The variable is renamed across the project, which in our case is only two places.

   

3. Now take a look at IntelliSense. Below the line that says Console.WriteLine($"\nHello {username}!");, type DateTime now = DateTime..

   A box displays the members of the DateTime class. The description of the currently selected member also displays in a separate box.

4. Select the member named Now, which is a property of the class, by double-clicking it or pressing Tab. Complete the line of code by adding a semicolon to the end of the line: DateTime now = DateTime.Now;.

5. Below that line, enter the following lines of code:

   int dayOfYear = now.DayOfYear;
   
   Console.Write("Day of year: ");
   Console.WriteLine(dayOfYear);
   

   Tip

   Console.Write is different from Console.WriteLine in that it doesn't add a line terminator after it prints. That means that the next piece of text that's sent to the output will print on the same line. You can hover over each of these methods in your code to see their descriptions.

6. Next, use refactoring again to make the code a little more concise. Select the variable now in the line DateTime now = DateTime.Now;. A screwdriver icon appears in the margin on that line.

7. Select the screwdriver icon to see available suggestions from Visual Studio. This case shows the Inline temporary variable refactoring to remove a line of code without changing the overall code behavior.

8. Select Inline temporary variable to refactor the code.

9. Run the program again by pressing Ctrl+F5. The output looks something like this:

Debug code

When you write code, you should run it and test it for bugs. Visual Studio's debugging system lets you step through code one statement at a time and inspect variables as you go. You can set breakpoints that stop execution of the code at a particular line, and observe how the variable value changes as the code runs.

Set a breakpoint to see the value of the username variable while the program is running.

1. Set a breakpoint on the line of code that says Console.WriteLine($"\nHello {username}!"); by clicking in the far-left margin, or gutter, next to the line. You can also select the line of code and then press F9.

   A red circle appears in the gutter, and the line is highlighted.

2. Start debugging by selecting Debug > Start Debugging or pressing F5.

3. When the console window appears and asks for your name, enter your name.

   The focus returns to the Visual Studio code editor, and the line of code with the breakpoint is highlighted in yellow. The yellow highlight means that this line of code will execute next. The breakpoint makes the app pause execution at this line.

4. Hover your mouse over the username variable to see its value. You can also right-click on username and select Add Watch to add the variable to the Watch window, where you can also see its value.

5. Press F5 again to finish running the app.

For more information about debugging in Visual Studio, see the Debugger feature tour.

Customize Visual Studio

You can personalize the Visual Studio user interface, including changing the default color theme. To change the color theme:

1. On the menu bar, choose Tools > Options to open the Options dialog.

2. On the Environment > General options page, change the Color theme selection to Dark, and then choose OK.

   The color theme for the entire IDE changes to Dark.

   

To learn about other ways you can personalize the IDE, see Personalize Visual Studio.

Select environment settings

You can configure Visual Studio to use environment settings tailored to C# developers:

1. On the menu bar, choose Tools > Import and Export Settings.

2. In the Import and Export Settings Wizard, select Reset all settings, and then select Next.

3. On the Save Current Settings page, choose whether to save your current settings before resetting. If you haven't customized any settings, select No, just reset settings, overwriting my current settings. Then select Next.

4. On the Choose a Default Collection of Settings page, choose Visual C#, and then select Finish.

5. On the Reset Complete page, select Close.

To learn about other ways you can personalize the IDE, see Personalize Visual Studio.

Next steps

Explore Visual Studio further by following along with one of these introductory articles:

Learn to use the code editor

Learn about projects and solutions

See also

• Discover more Visual Studio features.
• Visit visualstudio.microsoft.com.
• Read the Visual Studio blog.