Skip to main content
.NET Framework Class Library
Stream..::.Write Method

Updated: December 2010

When overridden in a derived class, writes a sequence of bytes to the current stream and advances the current position within this stream by the number of bytes written.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Syntax
Public MustOverride Sub Write ( _
	buffer As Byte(), _
	offset As Integer, _
	count As Integer _
)
public abstract void Write(
	byte[] buffer,
	int offset,
	int count
)
public:
virtual void Write(
	array<unsigned char>^ buffer, 
	int offset, 
	int count
) abstract
abstract Write : 
        buffer:byte[] * 
        offset:int * 
        count:int -> unit 

Parameters

buffer
Type: array<System..::.Byte>[]()[]
An array of bytes. This method copies count bytes from buffer to the current stream.
offset
Type: System..::.Int32
The zero-based byte offset in buffer at which to begin copying bytes to the current stream.
count
Type: System..::.Int32
The number of bytes to be written to the current stream.
Remarks

Use the CanWrite property to determine whether the current instance supports writing.

If the write operation is successful, the position within the stream advances by the number of bytes written. If an exception occurs, the position within the stream remains unchanged.

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.
Change History

Date

History

Reason

December 2010

Removed example and removed note about BeginWrite.

Information enhancement.