TextWriter.WriteLine Method (String, Object[])

Writes out a formatted string and a new line, using the same semantics as Format.

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

abstract WriteLine : 
        format:string * 
        arg:Object[] -> unit 
override WriteLine : 
        format:string * 
        arg:Object[] -> unit 

Parameters

format
Type: System.String
The formatting string.
arg
Type: System.Object[]
The object array to write into format string.

ExceptionCondition
ArgumentNullException

A string or object is passed in as a null reference (Nothing in Visual Basic).

ObjectDisposedException

The TextWriter is closed.

IOException

An I/O error occurs.

FormatException

The format specification in format is invalid.

-or-

The number indicating an argument to be formatted is less than zero, or larger than or equal to arg.Length.

This method uses composite formatting to convert the value of an object to its string representation. The FormatProvider property, if not a null reference (Nothing in Visual Basic), specifies the culture-specific formatting. For more information, see Composite Formatting. This method does not search the specified String for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

If a specified object is not referenced in the format string, it is ignored.

For a list of common I/O tasks, see Common I/O Tasks.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft