This documentation is archived and is not being maintained.

TextWriter::Write Method (String, Object, Object)

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

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

virtual void Write(
	String^ format, 
	Object^ arg0, 
	Object^ arg1


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


format is nullptr.


The TextWriter is closed.


An I/O error occurs.


The format specification in format is invalid.


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 nullptr, 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.