This documentation is archived and is not being maintained.

Console.WriteLine Method (String, Object, Object, Object, Object, ...)

.NET Framework 1.1

Writes the specified objects and variable length parameter list, followed by the current line terminator, to the standard output stream using the specified format information.

This method is not CLS-compliant. For more information about CLS compliance, see What is the Common Language Specification.

[C++]
[CLSCompliant(false)]
public: static void WriteLine(
 String* format,
 Object* arg0,
 Object* arg1,
 Object* arg2,
 Object* arg3,
   ...
);

[Visual Basic] This method cannot be used in Visual Basic.

[C#] This method cannot be used in C#.

[JScript] This method cannot be used in JScript.

Parameters [C++]

format
The format string.
arg0
The first object to write using format.
arg1
The second object to write using format.
arg2
The third object to write using format.
arg3
The fourth object to write using format.

Exceptions [C++]

Exception Type Condition
IOException An I/O error occurred.
ArgumentNullException format is a null reference (Nothing in Visual Basic).
FormatException The format specification in format is invalid.

Remarks [C++]

This method uses the same semantics as String.Format.

If a parameter object is not referenced in format, it is ignored.

For more information about the line terminator, see the Remarks section of the WriteLine method that takes no parameters.

Example

The following code sample illustrates the use of WriteLine:

[Visual Basic] 
Public Class TipCalculator
   Private Const tipRate As Double = 0.18
   
   'Entry point which delegates to C-style main Private Function
   Public Overloads Shared Sub Main()
      System.Environment.ExitCode = Main(System.Environment.GetCommandLineArgs())
   End Sub
   
   Overloads Public Shared Function Main(args() As String) As Integer
      Dim billTotal As Double
      If args.Length < 2 Then
         Console.WriteLine("usage: TIPCALC total")
         Return 1
      Else
         Try
            billTotal = Double.Parse(args(1))
         Catch
            Console.WriteLine("usage: TIPCALC total")
            Return 1
         End Try
         Dim tip As Double = billTotal * tipRate
         Console.WriteLine()
         Console.WriteLine("Bill total:" + ControlChars.Tab + "{0,8:c}", billTotal)
         Console.WriteLine("Tip total/rate:" + ControlChars.Tab + "{0,8:c} ({1:p1})", tip, tipRate)
         Console.WriteLine("".PadRight(24, "-"c))
         Console.WriteLine("Grand total:" + ControlChars.Tab + "{0,8:c}", billTotal + tip)
         Return 0
      End If
   End Function 'Main
End Class 'TipCalculator

[C#] 
public class TipCalculator {
    private const double tipRate = 0.18;
    public static int Main(string[] args) {
        double billTotal;
        if (args.Length == 0) {
            Console.WriteLine("usage: TIPCALC total");
            return 1;
        }
        else {
            try {
                billTotal = Double.Parse(args[0]);
            }
            catch(FormatException) {
                Console.WriteLine("usage: TIPCALC total");
                return 1;
            }
            double tip = billTotal * tipRate;
            Console.WriteLine();
            Console.WriteLine("Bill total:\t{0,8:c}", billTotal);
            Console.WriteLine("Tip total/rate:\t{0,8:c} ({1:p1})", tip, tipRate);
            Console.WriteLine(("").PadRight(24, '-'));
            Console.WriteLine("Grand total:\t{0,8:c}", billTotal + tip);
            return 0;
        }
    }
}

[C++] 
int main() {
String* args[] = Environment::GetCommandLineArgs();
    const double tipRate = 0.18;

    double billTotal;
    if (args->Length != 2) {
        Console::WriteLine(S"usage: TIPCALC total");
        return 1;
    }
    else {
        try {
            billTotal = Double::Parse(args[1]);
        }
        catch(FormatException*) {
            Console::WriteLine(S"usage: TIPCALC total");
            return 1;
        }
        double tip = billTotal * tipRate;
        Console::WriteLine();
        Console::WriteLine(S"Bill total:\t{0,8:c}", __box(billTotal));
        Console::WriteLine(S"Tip total/rate:\t{0,8:c} ({1:p1})", __box(tip), __box(tipRate));
        Console::WriteLine((S"")->PadRight(24, '-'));
        Console::WriteLine(S"Grand total:\t{0,8:c}", __box(billTotal + tip));
        return 0;
    }
}

[JScript] 

const tipRate : Number = 0.18;
var billTotal : Number;
var args : String[] = Environment.GetCommandLineArgs();

if (args.Length != 2) {
Console.WriteLine("usage: TIPCALC total");
Environment.Exit(1);
}

try {
billTotal = Double.Parse(args[1]);
}
catch(FormatException) {
Console.WriteLine("usage: TIPCALC total");
Environment.Exit(1);
}

var tip : double = billTotal * tipRate;
Console.WriteLine();
Console.WriteLine("Bill total:\t{0,8:c}", billTotal);
Console.WriteLine("Tip total/rate:\t{0,8:c} ({1:p1})", tip, tipRate);
Console.WriteLine(("").PadRight(24, '-'));
Console.WriteLine("Grand total:\t{0,8:c}", billTotal + tip);

Requirements [C++]

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Console Class | Console Members | System Namespace | Console.WriteLine Overload List | Formatting Overview | Read | ReadLine | Write

Show: