Hello World -- Your First Program (C# Programming Guide)

The following procedure creates a C# version of the traditional "Hello World!" program. The program displays the string Hello World!

For more examples of introductory concepts, see Getting Started Tutorials.

To create and run a console application

1. Start Visual Studio.

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

   The New Project dialog box opens.

3. Expand Installed, expand Templates, expand Visual C#, and then choose Console Application.

4. In the Name box, specify a name for your project, and then choose the OK button.

   The new project appears in Solution Explorer.

5. 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.

6. Replace the contents of Program.cs with the following code.

   // A Hello World! program in C#. 
   using System;
   namespace HelloWorld
   {
       class Hello 
       {
           static void Main() 
           {
               Console.WriteLine("Hello World!");
   
               // Keep the console window open in debug mode.
               Console.WriteLine("Press any key to exit.");
               Console.ReadKey();
           }
       }
   }
   

7. Choose the F5 key to run the project. A Command Prompt window appears that contains the line Hello World!

Next, the important parts of this program are examined.

Comments

The first line contains a comment. The characters // convert the rest of the line to a comment.

// A Hello World! program in C#.

You can also comment out a block of text by enclosing it between the /* and */ characters. This is shown in the following example.

/* A "Hello World!" program in C#.
This program displays the string "Hello World!" on the screen. */

Main Method

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.

The Main method is a static (C# Reference) 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 void.

  static void Main()
  {
      //...
  }
  

• It can also return an integer.

  static int Main()
  {
      //... 
      return 0;
  }
  

• With either of the return types, it can take arguments.

  static void Main(string[] args)
  {
      //...
  }
  

  -or-

  static int Main(string[] args)
  {
      //... 
      return 0;
  }
  

The parameter of the Main method, 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 (C# Programming Guide) and How to: Create and Use Assemblies Using the Command Line (C# and Visual Basic).

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.

Input and Output

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 System.Console.WriteLine:

using System;

Console.WriteLine("Hello World!");

For more information about input/output methods, see System.IO.

Command-Line Compilation and Execution

You can compile the "Hello World!" program by using the command line instead of the Visual Studio Integrated Development Environment (IDE).

To compile and run from a command prompt

1. 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 .cs.

2. 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.

     See How to: Set Environment Variables.

3. In the command-prompt window, navigate to the folder that contains your Hello.cs file.

4. Enter the following command to compile Hello.cs.

   csc Hello.cs

   If your program has no compilation errors, an executable file that is named Hello.exe is created.

5. In the command-prompt window, enter the following command to run the program:

   Hello

For more information about the C# compiler and its options, see C# Compiler Options.

Featured Book Chapter

Writing a C# Program in Beginning Visual C# 2010

See Also

Tasks

C# Sample Applications

Reference

Inside a C# Program

Concepts

C# Programming Guide

Main() and Command-Line Arguments (C# Programming Guide)

Other Resources

Strings (C# Programming Guide)

C# Reference

Getting Started Tutorials