Information
Switch
Switch
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

StreamWriter::Null Field

.NET Framework (current version)
 

Provides a StreamWriter with no backing store that can be written to, but not read from.

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

C#
C++
F#
VB
Copy 
public:
static initonly StreamWriter^ Null

Field Value

Type: System.IO::StreamWriter^

Use Null to redirect output to a StreamWriter that will not consume any operating system resources.

When the StreamWriter.Write methods are invoked on Null, the call simply returns, and no data is actually written to any backing store.

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

The following example demonstrates a use of the Null field.

C#
C++
VB
Copy 
if ( sw->Equals( StreamWriter::Null ) )
{
   sw->WriteLine( "The store can be written to, but not read from." );
}

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: