Console.WriteLine Method (String, Object[])

 

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

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

[<HostProtectionAttribute(SecurityAction.LinkDemand, UI = true)>]
static member WriteLine : 
        format:string *
        [<ParamArrayAttribute>] arg:Object[] -> unit

Parameters

format
Type: System.String

A composite format string (see Remarks).

arg
Type: System.Object[]

An array of objects to write using format.

Exception Condition
IOException

An I/O error occurred.

ArgumentNullException

format or arg is null.

FormatException

The format specification in format is invalid.

This method uses the composite formatting feature of the .NET Framework to convert the value of an object to its text representation and embed that representation in a string. The resulting string is written to the output stream.

The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. The formatting process replaces each format item with the text representation of the value of the corresponding object.

The syntax of a format item is {index[,alignment][:formatString]}, which specifies a mandatory index, the optional length and alignment of the formatted text, and an optional string of format specifier characters that govern how the value of the corresponding object is formatted.

The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics.

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

Notes to Callers:

This method is not called by C++ code. The C++ compiler resolves calls to WriteLine that include a string and a list of four or more object parameters as a call to WriteLine(String, Object, Object, Object, Object). It resolves calls to WriteLine that include a string and an object array as a call to WriteLine(String, Object).

The following example demonstrates the standard formatting specifiers for numbers, dates, and enumerations.

No code example is currently available or this language may not be supported.

The following example is a tip calculator that calculates an 18% tip and uses the WriteLine method to display the amount of the original charge, the amount of the tip, and the total amount. The example is a console application that requires the user to supply the amount of the original charge as a command-line parameter.

No code example is currently available or this language may not be supported.

UIPermission

for modifying safe top-level windows and subwindows. Associated enumeration: UIPermissionWindow.SafeTopLevelWindows

.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show: