TextWriter.WriteLine Method (String, Object) (System.IO)

Switch View :
ScriptFree
.NET Framework Class Library
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)
Syntax

Visual Basic
Public Overridable Sub WriteLine ( _
	format As String, _
	arg0 As Object _
)
C#
public virtual void WriteLine(
	string format,
	Object arg0
)
Visual C++
public:
virtual void WriteLine(
	String^ format, 
	Object^ arg0
)
F#
abstract WriteLine : 
        format:string * 
        arg0:Object -> unit 
override WriteLine : 
        format:string * 
        arg0:Object -> unit 

Parameters

format
Type: System.String
The formatted string.
arg0
Type: System.Object
The object to write into the formatted string.
Exceptions

Exception Condition
ArgumentNullException

format is null.

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 the number of provided objects to be formatted.

Remarks

This method uses composite formatting to convert the value of an object to its string representation. The FormatProvider property, if not null, 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.

Version Information

.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
Platforms

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.
See Also

Reference

Other Resources