Write Method

Stream.Write Method (Byte[], Int32, Int32)

 

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)

public abstract void Write(
	byte[] buffer,
	int offset,
	int count
)

Parameters

buffer
Type: 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.

Exception Condition
ArgumentException

The sum of offset and count is greater than the buffer length.

ArgumentNullException

buffer is null.

ArgumentOutOfRangeException

offset or count is negative.

IOException

An I/O error occured, such as the specified file cannot be found.

NotSupportedException

The stream does not support writing.

ObjectDisposedException

Write was called after the stream was closed.

Use the CanWrite property to determine whether the current instance supports writing. Use the WriteAsync method to write asynchronously to the current stream.

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.

Universal Windows Platform
Available since 4.5
.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:
© 2016 Microsoft