TextWriter.Write Method (String, Object)

Writes out a formatted string, using the same semantics as String.Format.

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

public virtual void Write(
	string format,
	Object arg0
)

Parameters

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

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

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.

.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

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