Skip to content

Commit d624e51

Browse files
committed
Merging changes synced from https://github.com/MicrosoftDocs/visualstudio-docs-pr (branch live)
2 parents 05542e0 + e5a382d commit d624e51

22 files changed

+240
-57
lines changed
-62.2 KB
Loading
-55.4 KB
Loading
-31.4 KB
Loading

docs/ide/media/error-list-dark.png

8.6 KB
Loading
9.36 KB
Loading

docs/ide/media/menu-bar-dark.png

5.3 KB
Loading

docs/ide/media/output-window-dark.png

8.21 KB
Loading
7.93 KB
Loading

docs/ide/media/send-feedback-dark.png

4.66 KB
Loading
Loading

docs/ide/media/start-page-dark.png

67.8 KB
Loading
Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
---
2+
title: Tour of the Visual Studio IDE
3+
ms.date: 07/12/2018
4+
ms.prod: visual-studio-dev15
5+
ms.technology: vs-ide-general
6+
ms.topic: quickstart
7+
author: gewarren
8+
ms.author: gewarren
9+
manager: douge
10+
ms.workload:
11+
- "multiple"
12+
experiment_id: 92a235b7-7520-4b
13+
---
14+
# Quickstart: First look at the Visual Studio IDE
15+
16+
In this 5-10 minute introduction to the Visual Studio integrated development environment (IDE), we'll take a tour of some of the windows, menus, and other UI features.
17+
18+
If you haven't already installed Visual Studio, go to the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=button+cta&utm_content=download+vs2017) page to install it for free.
19+
20+
## Start Page
21+
22+
The first thing you'll see after you launch Visual Studio is most likely the **Start Page**. The **Start Page** is designed as a "hub" to help you find the commands and project files you need faster. The **Recent** section displays projects and folders you've worked on recently. Under **New project**, you can click a link to bring up the **New Project** dialog box, or under **Open**, you can open an existing project or code folder. On the right is a feed of the latest developer news.
23+
24+
![Start Page in Visual Studio](media/start-page-dark.png)
25+
26+
If you close the **Start Page** and want to see it again, you can reopen it from the **File** menu.
27+
28+
![File menu in Visual Studio](media/file-menu-start-page-dark.png)
29+
30+
To continue exploring the IDE, let's create a new project.
31+
32+
1. On the **Start Page**, in the search box under **New project**, enter **console** to filter the list of project types. Choose either a C# or VB **Console App (.NET Framework)**. (Alternatively, if you are a C++, Javascript, or other language developer, feel free to create a project in one of those languages. The UI we'll be looking at is similar for all languages.)
33+
34+
1. In the **New Project** dialog box, accept the default project name and choose **OK**.
35+
36+
The project is created and a file named *Program.cs* or *Program.vb* opens in the **Editor** window. The **Editor** shows the contents of files, and is where you'll do most of your coding work in Visual Studio.
37+
38+
## Solution Explorer
39+
40+
**Solution Explorer** shows you a graphical representation of the hierarchy of files and folders in your project, solution, or code folder. You can browse the hierarchy and navigate to a file in **Solution Explorer**.
41+
42+
![Solution Explorer in Visual Studio](media/solution-explorer-console-app-dark.png)
43+
44+
## Menus
45+
46+
The menu bar along the top of the IDE groups commands into categories. For example, the **Project** menu contains commands related to the project you're working in. On the **Tools** menu, you can customize the IDE by selecting **Options**, or add features to your installation by selecting **Get Tools and Features**.
47+
48+
![Menu bar in Visual Studio](media/menu-bar-dark.png)
49+
50+
Let's open the **Error List** window by choosing the **View** menu, and then **Error List**.
51+
52+
## Error List
53+
54+
The **Error List** shows you errors, warning, and messages regarding the current state of your code. If there were any errors (such as a syntax typo) in your file, or anywhere in your project, they would be listed here.
55+
56+
![Error List in Visual Studio](media/error-list-dark.png)
57+
58+
## Output window
59+
60+
The **Output** window shows you output messages from Build and Source Control.
61+
62+
Let's build the project to see some output logging. From the **Build** menu, choose **Build Solution**. The **Output** window automatically obtains focus and display a successful build message.
63+
64+
![Output window in Visual Studio](media/output-window-dark.png)
65+
66+
## Quick Launch
67+
68+
The **Quick Launch** box is a quick and easy way to do pretty much anything in the IDE. You can enter some text related to what you want to do, and it'll show you a list of options that pertain to the text. For example, let's say we want to increase the build output's verbosity to display additional logging information about what exactly build is doing:
69+
70+
1. Enter **verbosity** into the **Quick Launch** box, and then choose **Projects and Solutions --> Build and Run** under the **Options** category.
71+
72+
![Quick launch box in Visual Studio](media/quick-launch-verbosity-dark.png)
73+
74+
The **Options** dialog box opens to the **Build and Run** options page.
75+
76+
1. Under **MSBuild project build output verbosity**, choose **Normal**, and then click **OK**.
77+
78+
1. Now we'll build the project again by right-clicking on the **ConsoleApp1** project in **Solution Explorer**, and choosing **Rebuild** from the context menu.
79+
80+
This time the **Output** window shows more verbose logging from the build process, including which files were copied where.
81+
82+
## Send Feedback menu
83+
84+
Should you encounter any problems while you're using Visual Studio, or if you have suggestions for how to improve the product, you can use the **Send Feedback** menu at the top of the IDE, next to the **Quick Launch** box.
85+
86+
![Send Feedback menu in Visual Studio](media/send-feedback-dark.png)
87+
88+
## Next steps
89+
90+
We've looked at just a few of the features of the Visual Studio IDE to get acquainted with the user interface. To explore further:
91+
92+
- Browse the **General User Interface Elements** section of the VS documentation, which goes into more depth about windows such as the [Error List](../ide/reference/error-list-window.md), [Output window](../ide/reference/output-window.md), [Properties window](../ide/reference/properties-window.md), and [Options dialog box](../ide/reference/options-dialog-box-visual-studio.md)
93+
94+
- Take a more in-depth tour of the IDE, and even dabble in debugging, in [Overview of the Visual Studio IDE](../ide/visual-studio-ide.md)
95+
96+
## See also
97+
98+
- [Quickstart: Personalize the IDE](../ide/personalizing-the-visual-studio-ide.md)
99+
- [Quickstart: Write code in the editor](../ide/quickstart-editor.md)
100+
- [Quickstart: Projects and solutions](../ide/quickstart-projects-solutions.md)

docs/ide/quickstart-ide-orientation.md

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Tour of the Visual Studio IDE
3-
ms.date: 11/15/2017
3+
ms.date: 07/12/2018
44
ms.prod: visual-studio-dev15
55
ms.technology: vs-ide-general
66
ms.topic: quickstart
@@ -9,6 +9,8 @@ ms.author: gewarren
99
manager: douge
1010
ms.workload:
1111
- "multiple"
12+
experimental: true​
13+
experiment_id: 92a235b7-7520-4b
1214
---
1315
# Quickstart: First look at the Visual Studio IDE
1416

@@ -20,15 +22,15 @@ If you haven't already installed Visual Studio, go to the [Visual Studio downloa
2022

2123
The first thing you'll see after you launch Visual Studio is most likely the **Start Page**. The **Start Page** is designed as a "hub" to help you find the commands and project files you need faster. The **Recent** section displays projects and folders you've worked on recently. Under **New project**, you can click a link to bring up the **New Project** dialog box, or under **Open**, you can open an existing project or code folder. On the right is a feed of the latest developer news.
2224

23-
![VS Start Page](media/quickstart-IDE-start-page.png)
25+
![Start Page in Visual Studio](media/quickstart-IDE-start-page.png)
2426

2527
If you close the **Start Page** and want to see it again, you can reopen it from the **File** menu.
2628

27-
![File menu](media/quickstart-IDE-file-menu-large.png)
29+
![File menu in Visual Studio](media/quickstart-IDE-file-menu-large.png)
2830

2931
To continue exploring the IDE, let's create a new project.
3032

31-
1. On the **Start Page**, in the search box under **New project**, enter `console` to filter the list of project types. Choose either a C# or VB **Console App (.NET Framework)**. (Alternatively, if you are a C++, Javascript, or other language developer, feel free to create a project in one of those languages. The UI we'll be looking at is similar for all languages.)
33+
1. On the **Start Page**, in the search box under **New project**, enter **console** to filter the list of project types. Choose either a C# or VB **Console App (.NET Framework)**. (Alternatively, if you are a C++, Javascript, or other language developer, feel free to create a project in one of those languages. The UI we'll be looking at is similar for all languages.)
3234

3335
1. In the **New Project** dialog box, accept the default project name and choose **OK**.
3436

@@ -38,37 +40,37 @@ To continue exploring the IDE, let's create a new project.
3840

3941
**Solution Explorer** shows you a graphical representation of the hierarchy of files and folders in your project, solution, or code folder. You can browse the hierarchy and navigate to a file in **Solution Explorer**.
4042

41-
![Solution Explorer](media/quickstart-IDE-solution-explorer.png)
43+
![Solution Explorer in Visual Studio](media/quickstart-IDE-solution-explorer.png)
4244

4345
## Menus
4446

4547
The menu bar along the top of the IDE groups commands into categories. For example, the **Project** menu contains commands related to the project you're working in. On the **Tools** menu, you can customize the IDE by selecting **Options**, or add features to your installation by selecting **Get Tools and Features**.
4648

47-
![Menu bar](media/quickstart-IDE-menu-bar.png)
49+
![Menu bar in Visual Studio](media/quickstart-IDE-menu-bar.png)
4850

4951
Let's open the **Error List** window by choosing the **View** menu, and then **Error List**.
5052

5153
## Error List
5254

5355
The **Error List** shows you errors, warning, and messages regarding the current state of your code. If there were any errors (such as a syntax typo) in your file, or anywhere in your project, they would be listed here.
5456

55-
![Error List](media/quickstart-IDE-error-list.png)
57+
![Error List in Visual Studio](media/quickstart-IDE-error-list.png)
5658

5759
## Output window
5860

5961
The **Output** window shows you output messages from Build and Source Control.
6062

6163
Let's build the project to see some output logging. From the **Build** menu, choose **Build Solution**. The **Output** window automatically obtains focus and display a successful build message.
6264

63-
![Output Window](media/quickstart-IDE-output.png)
65+
![Output Window in Visual Studio](media/quickstart-IDE-output.png)
6466

6567
## Quick Launch
6668

6769
The **Quick Launch** box is a quick and easy way to do pretty much anything in the IDE. You can enter some text related to what you want to do, and it'll show you a list of options that pertain to the text. For example, let's say we want to increase the build output's verbosity to display additional logging information about what exactly build is doing:
6870

69-
1. Enter `verbosity` into the **Quick Launch** box, and then choose **Projects and Solutions --> Build and Run** under the **Options** category.
71+
1. Enter **verbosity** into the **Quick Launch** box, and then choose **Projects and Solutions --> Build and Run** under the **Options** category.
7072

71-
![Quick launch box](media/quickstart-IDE-quick-launch.png)
73+
![Quick launch box in Visual Studio](media/quickstart-IDE-quick-launch.png)
7274

7375
The **Options** dialog box opens to the **Build and Run** options page.
7476

@@ -82,7 +84,7 @@ The **Quick Launch** box is a quick and easy way to do pretty much anything in t
8284

8385
Should you encounter any problems while you're using Visual Studio, or if you have suggestions for how to improve the product, you can use the **Send Feedback** menu at the top of the IDE, next to the **Quick Launch** box.
8486

85-
![Send Feedback menu](media/quickstart-IDE-send-feedback.png)
87+
![Send Feedback menu in Visual Studio](media/quickstart-IDE-send-feedback.png)
8688

8789
## Next steps
8890

@@ -95,5 +97,5 @@ We've looked at just a few of the features of the Visual Studio IDE to get acqua
9597
## See also
9698

9799
- [Quickstart: Personalize the IDE](../ide/personalizing-the-visual-studio-ide.md)
98-
- [Quickstart: Coding in the editor](../ide/quickstart-editor.md)
100+
- [Quickstart: Write code in the editor](../ide/quickstart-editor.md)
99101
- [Quickstart: Projects and solutions](../ide/quickstart-projects-solutions.md)

docs/ide/template-parameters.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -115,3 +115,4 @@ In the *.vstemplate* file for the project template, include the `ReplaceParamete
115115

116116
- [Customize templates](../ide/customizing-project-and-item-templates.md)
117117
- [How to: Create project templates](../ide/how-to-create-project-templates.md)
118+
- [Template Schema Reference](../extensibility/visual-studio-template-schema-reference.md)

docs/install/using-visual-studio-vm.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Using Visual Studio on an Azure Virtual Machine"
33
description: "Learn how to use Visual Studio on an Azure Virtual Machine"
4-
ms.date: 03/03/2018
4+
ms.date: 07/10/2018
55
ms.technology: vs-acquisition
66
ms.prod: visual-studio-dev15
77
ms.topic: conceptual
@@ -53,14 +53,14 @@ We use the following command line to install Visual Studio when building the ima
5353

5454
```shell
5555
vs_enterprise.exe --allWorkloads --includeRecommended --passive ^
56-
add Microsoft.Net.Component.4.7.SDK ^
57-
add Microsoft.Net.Component.4.7.TargetingPack ^
58-
add Microsoft.Net.Component.4.6.2.SDK ^
59-
add Microsoft.Net.Component.4.6.2.TargetingPack ^
60-
add Microsoft.Net.ComponentGroup.4.7.DeveloperTools ^
61-
add Microsoft.VisualStudio.Component.FSharp ^
62-
add Component.GitHub.VisualStudio ^
63-
add Microsoft.VisualStudio.Component.LinqToSql
56+
--add Microsoft.Net.Component.4.7.SDK ^
57+
--add Microsoft.Net.Component.4.7.TargetingPack ^
58+
--add Microsoft.Net.Component.4.6.2.SDK ^
59+
--add Microsoft.Net.Component.4.6.2.TargetingPack ^
60+
--add Microsoft.Net.ComponentGroup.4.7.DeveloperTools ^
61+
--add Microsoft.VisualStudio.Component.FSharp ^
62+
--add Component.GitHub.VisualStudio ^
63+
--add Microsoft.VisualStudio.Component.LinqToSql
6464
```
6565

6666
If the images don't include a Visual Studio feature that you require, provide feedback through the feedback tool in the upper-right corner of the page.

docs/test/configure-unit-tests-by-using-a-dot-runsettings-file.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Run settings files are optional. If you don't require any special configuration,
1818

1919
## Specify a run settings file
2020

21-
Run settings files can be used to configure tests that are run from the command line, in the IDE, or in a [build workflow](/vsts/pipelines/test/getting-started-with-continuous-testing?view=vsts) using Visual Studio Team Services (VSTS) or Team Foundation Server (TFS).
21+
Run settings files can be used to configure tests that are run from the [command line](vstest-console-options.md), in the IDE, or in a [build workflow](/vsts/pipelines/test/getting-started-with-continuous-testing?view=vsts) using Visual Studio Team Services (VSTS) or Team Foundation Server (TFS).
2222

2323
### Specify a run settings file in the IDE
2424

@@ -40,6 +40,8 @@ To run tests from the command line, use *vstest.console.exe* and specify the set
4040
vstest.console.exe MyTestAssembly.dll /EnableCodeCoverage /Settings:CodeCoverage.runsettings
4141
```
4242

43+
For more information, see [VSTest.Console.exe command-line options](vstest-console-options.md).
44+
4345
## Customize tests
4446

4547
To customize your tests using a *.runsettings* file, follow these steps:

docs/test/how-to-select-the-active-run-setting-for-a-load-test.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ If your load test contains only one run setting node under the **Run Settings**
2424

2525
In the Load Test Editor, the active run setting is identified by the "[Active]" suffix.
2626

27-
## Selecting the Active Run Setting
27+
## Select the Active Run Setting
2828

2929
### To select the active run setting in a load test
3030

@@ -41,15 +41,15 @@ In the Load Test Editor, the active run setting is identified by the "[Active]"
4141
> [!NOTE]
4242
> You can override the active run setting by setting an environment variable named `Test.UseRunSetting=<run setting name>`. This is useful when you run a load test from the command line or from a batch file. This lets you choose different run settings without opening your load test.
4343
44+
## Specify the Run Setting to Use from the Command Line
4445

45-
## Specifying the Run Setting to Use from the Command Line
46-
You can override the default run settings in your load test by setting an environment variable from the command line:
46+
You can override the default run settings in your load test by setting an environment variable from the command line:
4747

48-
**Set Test.UseRunSetting=PreProdEnvironment**
48+
**Set Test.UseRunSetting=PreProdEnvironment**
4949

50-
And the run the test:
50+
And the run the test:
5151

52-
**mstest /testcontainer:loadtest1.loadtest**
52+
**mstest /testcontainer:loadtest1.loadtest**
5353

5454
## See also
5555

0 commit comments

Comments
 (0)