About PortController
Introduction
Purchasing PortController
Redistributing PortController
License Agreement
Support
Getting Started
How to Use PortController
PortController Sample Projects
Handling PortController Errors
Reference
Properties
AvailableSystemPorts
BaudRate Property
Break Property
BytesUsedRQ Property
BytesUsedTQ Property
Cd Property
Cts Property
DataBits Property
Dsr Property
Dtr Property
DtrDsr Property
EnableReadOnEventChar Property
EventChar Property
ForceBeginInvokeEventFiring Property
IsOpen Property
IsFileTransferInProgress Property
Parity Property
PortHandle Property
PortName Property
ReceiveBufferSize Property
Ring Property
Rts Property
RtsCts Property
StopBits Property
SystemPorts Property
TraceOutput Property
TransmitBufferSize
XoffByte Property
XonByte Property
XonXoff Property
Methods
CancelFileTransfer Method
ClearRQ Method
ClearTQ Method
Close Method
GetErrorStatus Method
Open Method
Read Method
ReadBinary Method
ReceiveFileXModem Method
ReceiveFileXModemCRC Method
ReceiveFileYModem Method
ReceiveFileZModem Method
SendFileXModem Method
SendFileXModem1k Method
SendFileYModem Method
SendFileZModem Method
SimulateReceivedXoff Method
SimulateReceivedXon Method
Write Method
WriteBinary Method
Events
OnBreakSignal Event
OnCdToggle Event
OnCtsToggle Event
OnDataReceived Event
OnDsrToggle Event
OnError Event
OnEventCharReceived Event
OnFileTransferComplete Event
OnFileTransferStatusUpdate Event
OnRing Event
OnTQEmpty Event

EnableReadOnEventChar Property

Enables and disables reading from the receive buffer when the EventChar is received.

Syntax

[Visual Basic]
object.EnableReadOnEventChar [ = value ]

[C#]
object.EnableReadOnEventChar [ = value ]

[C++]
object->EnableReadOnEventChar [ = value ]

Parameters

object

An object expression that evaluates to a PortController object.

value

A boolean value indicating whether the receive buffer is to be read when the EventChar is received.

Return Value

A boolean value indicating whether reading the receive queue upon receiving the event character is enabled.

Default

False

Remarks

When this property is true, upon receiving the EventChar, the receive queue is read up to and including the EventChar.

Errors

None

Example

[Visual Basic]
'Set EnableReadOnEventChar
myPortController.EnableReadOnEventChar = True

'Get EnableReadOnEventChar
Dim enableRead As Boolean
enableRead = myPortController.EnableReadOnEventChar


[C#]
// Set EnableReadOnEventChar
myPortController.EnableReadOnEventChar = true;

// Get EnableReadOnEventChar
Boolean bEnableRead = myPortController.EnableReadOnEventChar;


[C++]
// Set EnableReadOnEventChar
myPortController->EnableReadOnEventChar = true;

// Get EnableReadOnEventChar
Boolean bEnableRead = myPortController->EnableReadOnEventChar;

See Also

EventChar property | EvtCharReceived event