About PortController
Introduction
Purchasing PortController
Redistributing PortController
License Agreement
Support
Getting Started
How to Use PortController
Using PortController with Visual Basic
Using PortController with Visual C++
Using PortController with Delphi
How to Use Events
Handling Events in Visual Basic
Handling Events in Visual C++
Handling Events in Delphi
PortController Sample Projects
Reading and Writing Binary Data
Handling PortController Errors
Reference
Properties
BaudRate Property
Break Property
BytesUsedRQ Property
BytesUsedTQ Property
Cd Property
Cts Property
DataBits Property
Dsr Property
Dtr Property
DtrDsr Property
EnableReadOnEventChar Property
EventChar Property
Parity Property
PortHandle Property
PortName Property
Ring Property
Rts Property
RtsCts Property
StopBits Property
XonXoff Property
Methods
ClearRQ Method
ClearTQ Method
Close Method
GetErrorStatus Method
Open Method
Read Method
ReadBinary Method
Write Method
WriteBinary Method
SendXoff Method
SendXon Method
Events
BreakSignal Event
CdToggle Event
CtsToggle Event
DataReceived Event
DsrToggle Event
Error Event
EvtCharReceived Event
Ring Event
TQEmpty Event

PortName Property

Returns the name of the port ("COM1", "COM2", etc.).

Syntax

Visual Basic

object.PortName

Visual C++

object.GetPortName()

Delphi

object.PortName

Part Description
object An object expression that evaluates to a PortController object.

Example

Visual Basic

'Get port name
Dim portName As String
portName = myPortController.PortName

Visual C++

// Get port name
CString strPortName = m_myPortController.GetPortName();

Delphi

// Get port name
var portName: String;         // declare variable in the proper place
portName := myPortController.PortName;

Remarks

None

Returns

A string containing the name of the open port.

Errors

Reading the PortName property while the port is closed is not permitted and will cause the PortController to throw a "Port is closed" exception.

See Also

Open(), PortHandle