OpenSerialPort Method (String, Int32)

Ports.OpenSerialPort Method (String, Int32)

 

Creates and opens a SerialPort object.

Namespace:   Microsoft.VisualBasic.Devices
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

public SerialPort OpenSerialPort(
	string portName,
	int baudRate
)

Parameters

portName
Type: System.String

String. Required. Name of the port to open.

baudRate
Type: System.Int32

Integer. Baud rate of the port.

Return Value

Type: System.IO.Ports.SerialPort

An open SerialPort object, configured with the supplied arguments.

Exception Condition
ArgumentNullException

portName is Nothing or an empty string.

ArgumentException

baudRate is less than or equal to zero.

The My.Computer.Ports.OpenSerialPort method creates and opens a SerialPort object. The arguments to the OpenSerialPort method determine the settings of the SerialPort object.

Your code should close the SerialPort object when it is finished using the object. You can use the Close method to close the object explicitly or the Using statement to close it implicitly. See the example in this topic for more information.

The following table lists examples of tasks involving the My.Computer.Ports.OpenSerialPort method.

To

See

Dial a modem attached to a serial port

How to: Dial Modems Attached to Serial Ports in Visual Basic

Send a string to serial port

How to: Send Strings to Serial Ports in Visual Basic

Receive strings from a serial port

How to: Receive Strings From Serial Ports in Visual Basic

Project type

Available

Windows Application

Yes

Class Library

Yes

Console Application

Yes

Windows Control Library

Yes

Web Control Library

No

Windows Service

Yes

Web Site

No

This example describes how to send strings to the computer's COM1 serial port.

The Using block allows the application to close the serial port even if it generates an exception. All code that manipulates the serial port should appear within this block, or within a Try...Catch...Finally block with a call to use the Close method.

The WriteLine method sends the data to the serial port.

Sub SendSerialData(ByVal data As String)
    ' Send strings to a serial port.
    Using com1 As IO.Ports.SerialPort = 
            My.Computer.Ports.OpenSerialPort("COM1")
        com1.WriteLine(data)
    End Using
End Sub

For more information, see How to: Send Strings to Serial Ports in Visual Basic.

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft