BufferedStream.Write Method (System.IO)

Switch View :

ScriptFree

.NET Framework Class Library

BufferedStream.Write Method

Copies bytes to the buffered stream and advances the current position within the buffered stream by the number of bytes written.

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

Syntax

Visual Basic (Declaration)

Public Overrides Sub Write ( _
	array As Byte(), _
	offset As Integer, _
	count As Integer _
)

Visual Basic (Usage)

Dim instance As BufferedStream
Dim array As Byte()
Dim offset As Integer
Dim count As Integer

instance.Write(array, offset, count)

public override void Write(
	byte[] array,
	int offset,
	int count
)

Visual C++

public:
virtual void Write(
	array<unsigned char>^ array, 
	int offset, 
	int count
) override

JScript

public override function Write(
	array : byte[], 
	offset : int, 
	count : int
)

Parameters

array: Type: System.Byte[]
The byte array from which to copy count bytes to the current buffered stream.

offset: Type: System.Int32
The offset in the buffer at which to begin copying bytes to the current buffered stream.

count: Type: System.Int32
The number of bytes to be written to the current buffered stream.

Exceptions

Exception	Condition
ArgumentException	Length of array minus offset is less than count.
ArgumentNullException	array is null.
ArgumentOutOfRangeException	offset or count is negative.
IOException	The stream is closed or null.
NotSupportedException	The stream does not support writing.
ObjectDisposedException	Methods were called after the stream was closed.

Remarks

For an example of creating a file and writing text to a file, see How to: Write Text to a File. For an example of reading text from a file, see How to: Read Text from a File. For an example of reading from and writing to a binary file, see How to: Read and Write to a Newly Created Data File.

Examples

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

Visual Basic

' Send the data using the BufferedStream.
Console.WriteLine("Sending data using BufferedStream.")
startTime = DateTime.Now
For i As Integer = 1 To numberOfLoops
    bufStream.Write(dataToSend, 0, dataToSend.Length)
Next i

bufStream.Flush()
bufferedTime = DateTime.Now.Subtract(startTime).TotalSeconds
Console.WriteLine("{0} bytes sent In {1} seconds." & vbCrLf, _
    numberOfLoops * dataToSend.Length, _
    bufferedTime.ToString("F1"))

// Send the data using the BufferedStream.
Console.WriteLine("Sending data using BufferedStream.");
startTime = DateTime.Now;
for(int i = 0; i < numberOfLoops; i++)
{
    bufStream.Write(dataToSend, 0, dataToSend.Length);
}
bufStream.Flush();
bufferedTime = (DateTime.Now - startTime).TotalSeconds;
Console.WriteLine("{0} bytes sent in {1} seconds.\n",
    numberOfLoops * dataToSend.Length,
    bufferedTime.ToString("F1"));

Visual C++

// Send the data using the BufferedStream.
Console::WriteLine( "Sending data using BufferedStream." );
startTime = DateTime::Now;
for ( int i = 0; i < numberOfLoops; i++ )
{
   bufStream->Write( dataToSend, 0, dataToSend->Length );

}
bufStream->Flush();
bufferedTime = (DateTime::Now - startTime).TotalSeconds;
Console::WriteLine( "{0} bytes sent in {1} seconds.\n", (numberOfLoops * dataToSend->Length).ToString(), bufferedTime.ToString(  "F1" ) );

Platforms

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

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Reference

BufferedStream Class

BufferedStream Members

System.IO Namespace

CanWrite

Read

Other Resources

File and Stream I/O

How to: Read Text from a File

How to: Write Text to a File