TextWriter.Write Method (String, Object[]) (System.IO)

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

Visual Basic
Public Overridable Sub Write ( _
	format As String, _
	ParamArray arg As Object() _
)
C#
public virtual void Write(
	string format,
	params Object[] arg
)
Visual C++
public:
virtual void Write(
	String^ format, 
	... array<Object^>^ arg
)
F#
abstract Write : 
        format:string * 
        arg:Object[] -> unit 
override Write : 
        format:string * 
        arg:Object[] -> unit 

Parameters

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

Exception Condition
ArgumentNullException

format or arg 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 arg. Length.

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

Portable Class Library

Supported in: Portable Class Library
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