Export (0) Print
Expand All

NetworkStream.Read Method

Reads data from the NetworkStream.

Namespace:  System.Net.Sockets
Assembly:  System (in System.dll)

public override int Read(
	byte[] buffer,
	int offset,
	int size
)

Parameters

buffer
Type: System.Byte[]

An array of type Byte that is the location in memory to store data read from the NetworkStream.

offset
Type: System.Int32

The location in buffer to begin storing the data to.

size
Type: System.Int32

The number of bytes to read from the NetworkStream.

Return Value

Type: System.Int32
The number of bytes read from the NetworkStream.

ExceptionCondition
ArgumentNullException

The buffer parameter is null.

ArgumentOutOfRangeException

The offset parameter is less than 0.

-or-

The offset parameter is greater than the length of buffer.

-or-

The size parameter is less than 0.

-or-

The size parameter is greater than the length of buffer minus the value of the offset parameter.

-or-

An error occurred when accessing the socket. See the Remarks section for more information.

IOException

The underlying Socket is closed.

ObjectDisposedException

The NetworkStream is closed.

-or-

There is a failure reading from the network.

This method reads data into the buffer parameter and returns the number of bytes successfully read. If no data is available for reading, the Read method returns 0. The Read operation reads as much data as is available, up to the number of bytes specified by the size parameter. If the remote host shuts down the connection, and all available data has been received, the Read method completes immediately and return zero bytes.

NoteNote:

Check to see if the NetworkStream is readable by calling the CanRead property. If you attempt to read from a NetworkStream that is not readable, you will get an IOException.

NoteNote:

If you receive an IOException, check the InnerException property to determine if it was caused by a SocketException. If so, use the ErrorCode property to obtain the specific error code, and refer to the Windows Sockets version 2 API error code documentation in MSDN for a detailed description of the error.

The following code example uses DataAvailable to determine if data is available to be read. If data is available, it reads from the NetworkStream.

            // Examples for CanRead, Read, and DataAvailable. 

            // Check to see if this NetworkStream is readable. 
            if(myNetworkStream.CanRead){
                byte[] myReadBuffer = new byte[1024];
                StringBuilder myCompleteMessage = new StringBuilder();
                int numberOfBytesRead = 0;

                // Incoming message may be larger than the buffer size. 
                do{
                     numberOfBytesRead = myNetworkStream.Read(myReadBuffer, 0, myReadBuffer.Length);

					 myCompleteMessage.AppendFormat("{0}", Encoding.ASCII.GetString(myReadBuffer, 0, numberOfBytesRead));
				 					
                }
                while(myNetworkStream.DataAvailable);

                // Print out the received message to the console.
                Console.WriteLine("You received the following message : " +
                                             myCompleteMessage);
            }
            else{
                 Console.WriteLine("Sorry.  You cannot read from this NetworkStream.");
            }
// Check to see if this NetworkStream is readable.
if (myNetworkStream->CanRead) {
    Byte myReadBuffer[] = new Byte[1024];
    String* myCompleteMessage = S"";
    int numberOfBytesRead = 0;

    // Incoming message may be larger than the buffer size.
    do{
        numberOfBytesRead = myNetworkStream->Read(myReadBuffer, 0, myReadBuffer->Length);  
        myCompleteMessage = 
            String::Concat(myCompleteMessage, Encoding::ASCII->GetString(myReadBuffer, 0, numberOfBytesRead));  
    } while (myNetworkStream->DataAvailable);

    // Print out the received message to the console.
    Console::WriteLine(S"You received the following message : {0}", myCompleteMessage);
} else {
    Console::WriteLine(S"Sorry.  You cannot read from this NetworkStream.");
}

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, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

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.

.NET Framework

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

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

Community Additions

ADD
Show:
© 2015 Microsoft