Export (0) Print
Expand All

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

.NET Framework 1.1

Writes the specified objects, followed by the current line terminator, to the standard output stream using the specified format information.

[Visual Basic]
Overloads Public Shared Sub WriteLine( _
   ByVal format As String, _
   ByVal arg0 As Object, _
   ByVal arg1 As Object, _
   ByVal arg2 As Object _
)
[C#]
public static void WriteLine(
 string format,
 object arg0,
 object arg1,
 object arg2
);
[C++]
public: static void WriteLine(
 String* format,
 Object* arg0,
 Object* arg1,
 Object* arg2
);
[JScript]
public static function WriteLine(
   format : String,
 arg0 : Object,
 arg1 : Object,
 arg2 : Object
);

Parameters

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.

Exceptions

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

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

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

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

Show:
© 2014 Microsoft