restore missing tutorial file. (dotnet#2858)

See PR dotnet#2793 for details

Author: BillWagner

docs/csharp/getting-started/with-visual-studio.md

@@ -0,0 +1,85 @@
+---
+title: Building a C# Hello World application with .NET Core in Visual Studio 2017
+description: Learn how to build a simple .NET Core console application using Visual Studio 2017.
+keywords: .NET Core, .NET Core console application, Visual Studio 2017
+author: BillWagner
+ms.author: wiwagn
+ms.date: 05/15/2017
+ms.topic: article
+ms.prod: .net-core
+ms.technology: devlang-csharp
+ms.devlang: csharp
+ms.assetid: 97aa50bf-bdf8-416d-a56c-ac77504c14ea
+---
+
+# Building a C# Hello World application with .NET Core in Visual Studio 2017
+
+This topic provides a step-by-step introduction to building, debugging, and publishing a simple .NET Core console application using Visual Studio 2017. Visual Studio 2017 provides a full-featured development environment for building .NET Core applications. As long as the application doesn't have platform-specific dependencies, the application can run on any platform that .NET Core targets and on any system that has .NET Core installed.
+
+## Prerequisites
+
+[Visual Studio 2017](https://www.visualstudio.com/downloads/) with the ".NET Core cross-platform development" workload installed. 
+
+For more information, see the [Prerequisites for .NET Core on Windows](../../core/windows-prerequisites.md) topic.
+
+## A simple Hello World application
+
+Begin by creating a simple "Hello World" console application. Follow these steps:
+
+1. Launch Visual Studio 2017. Select **File** > **New** > **Project** from the menu bar. In the **Add New Project** dialog, select the **.NET Core** node followed by the **Console App (.NET Core)** project template. In the **Name** text box, type "HelloWorld". Select the **OK** button.
+
+   ![New Project dialog with Console App selected](./media/with-visual-studio/newproject.png)
+   
+1. Visual Studio loads the development environment. The C# Console Application template for .NET Core automatically defines a class, `Program`, with a single method, `Main`, that takes a <xref:System.String> array as an argument. `Main` is the application entry point, the method that's called automatically by the runtime when it launches the application. Any command-line arguments supplied when the application is launched are available in the *args* array.
+
+   ![Visual Studio and the new HelloWorld project](./media/with-visual-studio/devenv.png)
+
+   The template creates a simple "Hello World" application. It calls the <xref:System.Console.WriteLine(System.String)?displayProperty=fullName> method to display the literal string "Hello World!" in the console window. By selecting the **HelloWorld** button with the green arrow on the toolbar, you can run the program in Debug mode. If you do, the console window is visible for only a brief time interval before it closes. This occurs because the `Main` method terminates and the application ends as soon as the single statement in the `Main` method executes.
+
+1. To cause the application to pause before it closes the console window, add the following code immediately after the call to the <xref:System.Console.WriteLine(System.String)?displayProperty=fullName> method:
+
+   ```csharp
+   Console.Write("Press any key to continue...");
+   Console.ReadKey(true);
+   ```
+   This code prompts the user to press any key and then pauses the program until a key is pressed.
+
+1. On the menu bar, select **Build** > **Build Solution**. This compiles your program into an intermediate language (IL) that's converted into binary code by a just-in-time (JIT) compiler.
+
+1. Run the program by selecting the **HelloWorld** button with the green arrow on the toolbar.
+
+   ![Console window showing Hello World Press any key to continue](./media/with-visual-studio/helloworld1.png)
+
+1. Press any key to close the console window.
+
+## Enhancing the Hello World application
+
+Enhance your application to prompt the user for their name and display it along with the date and time. To modify and test the program, do the following:
+
+1. Enter the following C# code in the code window immediately after the opening bracket that follows the `public static void Main(string[] args)` line and before the first closing bracket:
+
+   [!code-csharp[GettingStarted#1](../../../samples/snippets/csharp/getting_started/with_visual_studio/helloworld.cs#1)]
+
+   ![Visual Studio Program c-sharp file with updated Main method](./media/with-visual-studio/codewindow.png)
+
+   This code displays "What is your name?" in the console window and waits until the user enters a string followed by the Enter key. It stores this string into a variable named `name`. It also retrieves the value of the <xref:System.DateTime.Now?displayProperty=fullName> property, which contains the current local time, and assigns it to a variable named `date`. Finally, it uses a [composite format string](../../standard/base-types/composite-format.md) to display these values in the console window.
+
+1. Compile the program by choosing **Build** > **Build Solution**.
+
+1. Run the program in Debug mode in Visual Studio by selecting the green arrow on the toolbar, pressing F5, or choosing the **Debug** > **Start Debugging** menu item. Respond to the prompt by entering a name and pressing the Enter key.
+
+   ![Console window with modified program output](./media/with-visual-studio/helloworld2.png)
+
+1. Press any key to close the console window.
+
+You've created and run your application. To develop a professional application, take some additional steps to make your application ready for release:
+
+- For information on debugging your application, see [Debugging your C# Hello World application with Visual Studio 2017](debugging-with-visual-studio.md).
+
+- For information on developing and publishing a distributable version of your application, see [Publishing your Hello World application with Visual Studio 2017](publishing-with-visual-studio.md).
+
+## Related topics
+
+Instead of a console application, you can also build a class library with .NET Core and Visual Studio 2017. For a step-by-step introduction, see [Building a class library with C# and .NET Core in Visual Studio 2017](library-with-visual-studio.md).
+
+You can also develop a .NET Core console app on Mac, Linux, and Windows by using [Visual Studio Code](https://code.visualstudio.com/), a downloadable code editor. For a step-by-step tutorial, see [Getting Started with Visual Studio Code](with-visual-studio-code.md).