Console Programming
Output
The example program below shows a couple of ways to output text:
using System;
public class HelloWorld
{
public static void Main()
{
Console.WriteLine("Hello World!"); // relies on "using
System;"
Console.Write("This is");
Console.Write("... my first program!\n");
System.Console.WriteLine("Goodbye World!"); // no "using" statement
required
}
}
The above code displays the following text:
Hello World!
This is... my first program!
Goodbye World!
That text is output using the System.Console class. The using statement at the top allows the compiler to find the Console class without specifying the System namespace each time it is used.
The middle lines use the Write() method, which does not automatically create a new line. To specify a new line, we can use the sequence backslash-n ( \n ). If for whatever reason we wanted to really show the \n character instead, we add a second backslash ( \\n ). The backslash is known as the escape character in C# because it is not treated as a normal character, but allows us to encode certain special characters (like a new line character).
Input
Input can be gathered in a similar method to outputing data using the Read() and ReadLine methods of that same System.Console class:
using System;
public class ExampleClass
{
public static void Main()
{
Console.WriteLine("Greetings! What is your name?");
Console.Write("My name is: ");
string name = Console.ReadLine();
Console.WriteLine("Nice to meet you, " + name);
Console.Read();
}
}
The above program requests the user's name and displays it back. The final Console.Read() waits for the user to enter a key before exiting the program.
to write to the Console.Error stream whenever an error occurred, you can tell your scheduler program to monitor this stream, and feedback any information that is sent to it. Instead of the Console appearing with the Error messages, your program may wish to log these to a file.
You may wish to revisit this after studying Streams and after learning about the Process class.
Custom console applications can have arguments as well.
using System;
public class ExampleClass
{
public static void Main(string[] args)
{
Console.WriteLine("First Name: " + args[0]);
Console.WriteLine("Last Name: " + args[1]);
Console.Read();
}
}
If the program above code is compiled to a program called username.exe, it can be executed from the command line using two arguments,
e.g. "Bill" and "Gates":
C:\>username.exe Bill Gates
Notice how the Main() method above has a string array parameter. The program assumes that there will be two arguments. That assumption makes the program unsafe. If it is run without the expected number of command line arguments, it will crash when it attempts to access the missing argument. To make the program more robust, we make we can check to see if the user entered all the required arguments.
using System;
public class Test
{
public static void Main(string[] args)
{
if(args.Length >= 1)
Console.WriteLine(args[0]);
if(args.Length >= 2)
Console.WriteLine(args[1]);
}
}
Try running the program with only entering your first name or no name at all. The string.Length property returns the total number of arguments.
If no arguments are given, it will return zero.
You are also able to group a single argument together by using the "" quote marks. This is particularly useful if you are expecting many parameters,
but there is a requirement for including spaces (e.g. file locations, file names, full names etc)
using System;
class Test
{
public static void Main(string[] args)
{
for(int index =0 ;index < args.Length; index++)
{
Console.WriteLine((index+1) + ": " + args[index]);
}
}
}
C:\> Test.exe Separate words "grouped together"
1: Separate
2: words
3: grouped together
Output
The example program below shows a couple of ways to output text:
using System;
public class HelloWorld
{
public static void Main()
{
Console.WriteLine("Hello World!"); // relies on "using
System;"
Console.Write("This is");
Console.Write("... my first program!\n");
System.Console.WriteLine("Goodbye World!"); // no "using" statement
required
}
}
The above code displays the following text:
Hello World!
This is... my first program!
Goodbye World!
That text is output using the System.Console class. The using statement at the top allows the compiler to find the Console class without specifying the System namespace each time it is used.
The middle lines use the Write() method, which does not automatically create a new line. To specify a new line, we can use the sequence backslash-n ( \n ). If for whatever reason we wanted to really show the \n character instead, we add a second backslash ( \\n ). The backslash is known as the escape character in C# because it is not treated as a normal character, but allows us to encode certain special characters (like a new line character).
Input
Input can be gathered in a similar method to outputing data using the Read() and ReadLine methods of that same System.Console class:
using System;
public class ExampleClass
{
public static void Main()
{
Console.WriteLine("Greetings! What is your name?");
Console.Write("My name is: ");
string name = Console.ReadLine();
Console.WriteLine("Nice to meet you, " + name);
Console.Read();
}
}
The above program requests the user's name and displays it back. The final Console.Read() waits for the user to enter a key before exiting the program.
Error
The Error output is used to divert error specific messages to the console. To a novice user this may seem fairly pointless, as this achieves the same as Output (as above). If you decide to write an application that runs another application (for example a scheduler), you may wish to monitor the output of that program - more specifically, you may only wish to be notified only of the errors that occur. If you coded your program to write to the Console.Error stream whenever an error occurred, you can tell your scheduler program to monitor this stream, and feedback any information that is sent to it. Instead of the Console appearing with the Error messages, your program may wish to log these to a file.
You may wish to revisit this after studying Streams and after learning about the Process class.
Command line arguments
Command line arguments are values that are passed to a console program before execution. For example, theWindows command prompt includes a copy command that takes two command line arguments. The first argument is the original file and the second is the location or name for the new copy. Custom console applications can have arguments as well.
using System;
public class ExampleClass
{
public static void Main(string[] args)
{
Console.WriteLine("First Name: " + args[0]);
Console.WriteLine("Last Name: " + args[1]);
Console.Read();
}
}
If the program above code is compiled to a program called username.exe, it can be executed from the command line using two arguments,
e.g. "Bill" and "Gates":
C:\>username.exe Bill Gates
Notice how the Main() method above has a string array parameter. The program assumes that there will be two arguments. That assumption makes the program unsafe. If it is run without the expected number of command line arguments, it will crash when it attempts to access the missing argument. To make the program more robust, we make we can check to see if the user entered all the required arguments.
using System;
public class Test
{
public static void Main(string[] args)
{
if(args.Length >= 1)
Console.WriteLine(args[0]);
if(args.Length >= 2)
Console.WriteLine(args[1]);
}
}
Try running the program with only entering your first name or no name at all. The string.Length property returns the total number of arguments.
If no arguments are given, it will return zero.
You are also able to group a single argument together by using the "" quote marks. This is particularly useful if you are expecting many parameters,
but there is a requirement for including spaces (e.g. file locations, file names, full names etc)
using System;
class Test
{
public static void Main(string[] args)
{
for(int index =0 ;index < args.Length; index++)
{
Console.WriteLine((index+1) + ": " + args[index]);
}
}
}
C:\> Test.exe Separate words "grouped together"
1: Separate
2: words
3: grouped together