This documentation is archived and is not being maintained.

StreamWriter.Null Field

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

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

public static readonly StreamWriter Null
public static final StreamWriter Null
public static final var Null : StreamWriter
Not applicable.

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.

if(sw.Equals(StreamWriter.Null)) 
{
    sw.WriteLine("The store can be written to, but not read from.");
}

if (sw.Equals(StreamWriter.Null)) {
    sw.WriteLine("The store can be written to, but not read from.");
}

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
Show: