SerialPort.BytesToRead Property

Note: This property is new in the .NET Framework version 2.0.

Gets the number of bytes of data in the receive buffer.

Namespace: System.IO.Ports
Assembly: System (in system.dll)

public int BytesToRead { get; }
/** @property */
public int get_BytesToRead ()

public function get BytesToRead () : int

Property Value

The number of bytes of data in the receive buffer.

Exception typeCondition

IOException

The port is in an invalid state.

InvalidOperationException

The stream is closed. This can occur because the Open method has not been called or the Close method has been called.

The receive buffer includes the serial driver's receive buffer as well as internal buffering in the SerialPort object itself.

NoteNote

The BytesToRead property can return a value larger than the ReadBufferSize property because the ReadBufferSize property represents only the Windows-created buffer while the BytesToRead property represents the SerialPort buffer in addition to the Windows-created buffer.

Windows 98, Windows 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 .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

.NET Compact Framework

Supported in: 2.0

Community Additions

ADD
Show: