AvailableSystemPorts Property

Returns a collection of port names available to be opened.

Syntax

[Visual Basic]
object.AvailableSystemPorts

[C#]
object.AvailableSystemPorts

[C++]
object->AvailableSystemPorts

Parameters

object

An object expression that evaluates to a PortController object.

Return Value

A StringCollection containing the names of the serial ports that are available to be opened.

Default

Empty

Remarks

This property returns only ports that exist on the system that are not in use by other processes (that is, each port that can be opened). To get a list of all ports on the system, regardless of state, examine the SystemPorts property.

Errors

If PortController is unable to determine the COM ports on the system, an "Unable to enumerate system ports." exception is thrown. It is likely, however, you will still be able to open a port directly using the Open() method.

Example

[Visual Basic]
Dim AvailableSystemPorts As System.Collections.Specialized.StringCollection
AvailableSystemPorts = myPortController.AvailableSystemPorts


[C#]
System.Collections.Specialized.StringCollection AvailableSystemPorts;
AvailableSystemPorts = myPortController.AvailableSystemPorts;


[C++]
System::Collections::Specialized::StringCollection *AvailableSystemPorts;
AvailableSystemPorts = myPortController->AvailableSystemPorts;

See Also