Hello World -- Your First Program (C# Programming Guide)
Updated: July 20, 2015
The following procedure creates a C# version of the traditional "Hello World!" program. The program displays the string
For more examples of introductory concepts, see Getting Started with Visual C# and Visual Basic.
Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Personalizing the IDE.
Start Visual Studio.
On the menu bar, choose File, New, Project.
The New Project dialog box opens.
Expand Installed, expand Templates, expand Visual C#, and then choose Console Application.
In the Name box, specify a name for your project, and then choose the OK button.
The new project appears in Solution Explorer.
If Program.cs isn't open in the Code Editor, open the shortcut menu for Program.cs in Solution Explorer, and then choose View Code.
Replace the contents of Program.cs with the following code.
Choose the F5 key to run the project. A Command Prompt window appears that contains the line
Next, the important parts of this program are examined.
The first line contains a comment. The characters
// convert the rest of the line to a comment.
You can also comment out a block of text by enclosing it between the
*/ characters. This is shown in the following example.
/* A "Hello World!" program in C#. This program displays the string "Hello World!" on the screen. */
A C# console application must contain a
Main method, in which control starts and ends. The
Main method is where you create objects and execute other methods.
Main method is a static method that resides inside a class or a struct. In the previous "Hello World!" example, it resides in a class named
Hello. You can declare the
Main method in one of the following ways:
It can return
It can also return an integer.
With either of the return types, it can take arguments.
The parameter of the
args, is a
string array that contains the command-line arguments used to invoke the program. Unlike in C++, the array does not include the name of the executable (exe) file.
For more information about how to use command-line arguments, see the examples in Main() and Command-Line Arguments and How to: Create and Use Assemblies Using the Command Line.
The call to ReadKey at the end of the
Main method prevents the console window from closing before you have a chance to read the output when you run your program in debug mode, by pressing F5.
C# programs generally use the input/output services provided by the run-time library of the .NET Framework. The statement
System.Console.WriteLine("Hello World!"); uses the WriteLine method. This is one of the output methods of the Console class in the run-time library. It displays its string parameter on the standard output stream followed by a new line. Other Console methods are available for different input and output operations. If you include the
using System; directive at the beginning of the program, you can directly use the System classes and methods without fully qualifying them. For example, you can call
Console.WriteLine instead of
For more information about input/output methods, see System.IO.
You can compile the "Hello World!" program by using the command line instead of the Visual Studio Integrated Development Environment (IDE).
Paste the code from the preceding procedure into any text editor, and then save the file as a text file. Name the file
Hello.cs. C# source code files use the extension
Perform one of the following steps to open a command-prompt window:
In Windows 8, on the Start screen, search for
Developer Command Prompt, and then tap or choose Developer Command Prompt for VS2012.
A Developer Command Prompt window appears.
In Windows 7, open the Start menu, expand the folder for the current version of Visual Studio, open the shortcut menu for Visual Studio Tools, and then choose Developer Command Prompt for VS2012.
A Developer Command Prompt window appears.
Enable command-line builds from a standard Command Prompt window.
In the command-prompt window, navigate to the folder that contains your
Enter the following command to compile
If your program has no compilation errors, an executable file that is named
In the command-prompt window, enter the following command to run the program:
For more information about the C# compiler and its options, see C# Compiler Options.