0 out of 2 rated this helpful - Rate this topic

SerialPort.BytesToRead Property

.NET Framework 3.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 ()

JScript

public function get BytesToRead () : int

XAML

Not applicable.

Property Value

The number of bytes of data in the receive buffer.

Exceptions

Exception type	Condition
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.

Remarks

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

Note:
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.

Platforms

Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0, 2.0

.NET Compact Framework

Supported in: 2.0

Reference

SerialPort Class
SerialPort Members
System.IO.Ports Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD