My.Computer.Ports.OpenSerialPort 方法

项目
08/18/2008

更新：2007 年 11 月

创建和打开 SerialPort 对象。

' Usage
Dim value As System.IO.Ports.SerialPort = My.Computer.Ports.OpenSerialPort(portName)
Dim value As System.IO.Ports.SerialPort = My.Computer.Ports.OpenSerialPort(portName ,baudRate)
Dim value As System.IO.Ports.SerialPort = My.Computer.Ports.OpenSerialPort(portName ,baudRate ,parity)
Dim value As System.IO.Ports.SerialPort = My.Computer.Ports.OpenSerialPort(portName ,baudRate ,parity ,dataBits)
Dim value As System.IO.Ports.SerialPort = My.Computer.Ports.OpenSerialPort(portName ,baudRate ,parity ,dataBits ,stopBits)
' Declaration
Public Function OpenSerialPort( _
   ByVal portName As String _
) As System.IO.Ports.SerialPort
' -or-
Public Function OpenSerialPort( _
   ByVal portName As String, _
   ByVal baudRate As Integer _
) As System.IO.Ports.SerialPort
' -or-
Public Function OpenSerialPort( _
   ByVal portName As String, _
   ByVal baudRate As Integer, _
   ByVal parity As System.IO.Ports.Parity _
) As System.IO.Ports.SerialPort
' -or-
Public Function OpenSerialPort( _
   ByVal portName As String, _
   ByVal baudRate As Integer, _
   ByVal parity As System.IO.Ports.Parity, _
   ByVal dataBits As Integer _
) As System.IO.Ports.SerialPort
' -or-
Public Function OpenSerialPort( _
   ByVal portName As String, _
   ByVal baudRate As Integer, _
   ByVal parity As System.IO.Ports.Parity, _
   ByVal dataBits As Integer, _
   ByVal stopBits As System.IO.Ports.StopBits _
) As System.IO.Ports.SerialPort

参数

portName
String。必选。要打开的端口的名称。
baudRate
Integer。端口的波特率。
parity
Parity。端口的奇偶校验。
dataBits
Integer。端口的数据位设置。
stopBits
StopBits。端口的停止位设置。

返回值

打开的 SerialPort 对象，已使用提供的参数配置它。

异常

下面的情况可能会导致异常：

portName 参数为 Nothing 或为空字符串 (ArgumentNullException)。
baudRate 或 dataBits 参数为零或负数 (ArgumentException)。
parity 参数类型不是 Parity 枚举值之一 (InvalidEnumArgumentException)。
stopBits 参数类型不是 StopBits 枚举值之一 (InvalidEnumArgumentException)。

备注

My.Computer.Ports.OpenSerialPort 方法创建并打开 SerialPort 对象。OpenSerialPort 方法的参数确定 SerialPort 对象的设置。

当代码使用完 SerialPort 对象时，应当关闭该对象。可以使用 Close 方法显式关闭此对象，或者使用 Using 语句隐式关闭此对象。有关更多信息，请参见此主题中的示例。

任务

下表列出了涉及 My.Computer.Ports.OpenSerialPort 方法的任务的示例。

要执行的操作	请参见
使用连接到串行端口的调制解调器拨号	如何：在 Visual Basic 中使用连接到串行端口的调制解调器拨号
向串行端口发送字符串	如何：在 Visual Basic 中将字符串发送到串行端口
从串行端口接收字符串	如何：在 Visual Basic 中从串行端口接收字符串

示例

此示例介绍如何将字符串发送到计算机的 COM1 串行端口。

Using 块允许应用程序即使在生成异常时也关闭串行端口。所有操作串行端口的代码都应放在此代码块中，或者放在包含对 Close 方法的调用的 Try...Catch...Finally 块中。

WriteLine 方法将数据发送到串行端口。

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

有关更多信息，请参见如何：在 Visual Basic 中将字符串发送到串行端口。