TextWriter.Write Method (String)

Writes a string to the text stream.

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

virtual void Write (
	String^ value
public void Write (
	String value
public function Write (
	value : String
Not applicable.



The string to write.

Exception typeCondition


The TextWriter is closed.


An I/O error occurs.

This version of Write is equivalent to Write .

This method does not search the specified String for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

If value is a null reference (Nothing in Visual Basic), nothing is written to the text stream.

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

This code example is part of a larger example provided for the TextWriter class.

void WriteText( TextWriter^ textWriter )
   textWriter->Write(  "Invalid file path characters are: " );
   textWriter->Write( Path::InvalidPathChars );
   textWriter->Write( Char::Parse( "." ) );

static void WriteText(TextWriter textWriter)
    textWriter.Write("Invalid file path characters are: ");
} //WriteText

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0

Community Additions