Ports.OpenSerialPort 方法

定义

命名空间:

Microsoft.VisualBasic.Devices

程序集:

Microsoft.VisualBasic.dll

创建并打开一个 SerialPort 对象。

重载

OpenSerialPort(String)	创建并打开一个 SerialPort 对象。
OpenSerialPort(String, Int32)	创建并打开一个 SerialPort 对象。
OpenSerialPort(String, Int32, Parity)	创建并打开一个 SerialPort 对象。
OpenSerialPort(String, Int32, Parity, Int32)	创建并打开一个 SerialPort 对象。
OpenSerialPort(String, Int32, Parity, Int32, StopBits)	创建并打开一个 SerialPort 对象。

OpenSerialPort(String)

创建并打开一个 SerialPort 对象。

public:
 System::IO::Ports::SerialPort ^ OpenSerialPort(System::String ^ portName);

public System.IO.Ports.SerialPort OpenSerialPort (string portName);

member this.OpenSerialPort : string -> System.IO.Ports.SerialPort

Public Function OpenSerialPort (portName As String) As SerialPort

参数

portName

String

String. 必需。 要打开的端口的名称。

返回

SerialPort

一个打开的 SerialPort 对象，用提供的参数配置。

例外

ArgumentNullException

portName 为 Nothing 或空字符串。

示例

此示例介绍如何将字符串发送到计算机的 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

有关详细信息，请参阅 如何：将字符串发送到串行端口。

注解

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

使用 完 对象后， SerialPort 代码应关闭 对象。 可以使用 Close 方法显式关闭对象，或使用 Using 语句隐式关闭对象。 有关详细信息，请参阅本主题中的示例。

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

功能	查看
拨打连接到串行端口的调制解调器	如何：使用连接到串行端口的调制解调器拨号
将字符串发送到串行端口	如何：将字符串发送到串行端口
从串行端口接收字符串	如何：从串行端口接收字符串

可用性（按项目类型）

项目类型	可用
Windows 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	否
Windows 服务	是
网站	否

另请参阅

• SerialPortNames
• Parity
• StopBits
• SerialPort
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中使用连接到串行端口的调制解调器拨号
• 如何：在 Visual Basic 中将字符串发送到串行端口
• 如何：在 Visual Basic 中从串行端口接收字符串
• Using 语句 (Visual Basic)

OpenSerialPort(String, Int32)

创建并打开一个 SerialPort 对象。

public:
 System::IO::Ports::SerialPort ^ OpenSerialPort(System::String ^ portName, int baudRate);

public System.IO.Ports.SerialPort OpenSerialPort (string portName, int baudRate);

member this.OpenSerialPort : string * int -> System.IO.Ports.SerialPort

Public Function OpenSerialPort (portName As String, baudRate As Integer) As SerialPort

参数

portName

String

String. 必需。 要打开的端口的名称。

baudRate

Int32

Integer. 端口的波特率。

返回

SerialPort

一个打开的 SerialPort 对象，用提供的参数配置。

例外

ArgumentNullException

portName 为 Nothing 或空字符串。

ArgumentException

baudRate 小于或等于零。

示例

此示例介绍如何将字符串发送到计算机的 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

有关详细信息，请参阅 如何：将字符串发送到串行端口。

注解

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

使用 完 对象后， SerialPort 代码应关闭 对象。 可以使用 Close 方法显式关闭对象，或使用 Using 语句隐式关闭对象。 有关详细信息，请参阅本主题中的示例。

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

功能	查看
拨打连接到串行端口的调制解调器	如何：使用连接到串行端口的调制解调器拨号
将字符串发送到串行端口	如何：将字符串发送到串行端口
从串行端口接收字符串	如何：从串行端口接收字符串

可用性（按项目类型）

项目类型	可用
Windows 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	否
Windows 服务	是
网站	否

另请参阅

• SerialPortNames
• Parity
• StopBits
• SerialPort
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中使用连接到串行端口的调制解调器拨号
• 如何：在 Visual Basic 中将字符串发送到串行端口
• 如何：在 Visual Basic 中从串行端口接收字符串
• Using 语句 (Visual Basic)

OpenSerialPort(String, Int32, Parity)

创建并打开一个 SerialPort 对象。

public:
 System::IO::Ports::SerialPort ^ OpenSerialPort(System::String ^ portName, int baudRate, System::IO::Ports::Parity parity);

public System.IO.Ports.SerialPort OpenSerialPort (string portName, int baudRate, System.IO.Ports.Parity parity);

member this.OpenSerialPort : string * int * System.IO.Ports.Parity -> System.IO.Ports.SerialPort

Public Function OpenSerialPort (portName As String, baudRate As Integer, parity As Parity) As SerialPort

参数

portName

String

String. 必需。 要打开的端口的名称。

baudRate

Int32

Integer. 端口的波特率。

parity

Parity

Parity. 端口的奇偶校验。

返回

SerialPort

一个打开的 SerialPort 对象，用提供的参数配置。

例外

ArgumentNullException

portName 为 Nothing 或空字符串。

ArgumentException

baudRate 小于或等于零。

InvalidEnumArgumentException

parity 不是 Parity 枚举值之一。

示例

此示例介绍如何将字符串发送到计算机的 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

有关详细信息，请参阅 如何：将字符串发送到串行端口。

注解

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

代码在使用 完 对象后，应将其关闭 SerialPort 。 可以使用 方法显式关闭对象，也可以使用 CloseUsing 语句隐式关闭对象。 有关详细信息，请参阅本主题中的示例。

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

功能	查看
拨打连接到串行端口的调制解调器	如何：使用连接到串行端口的调制解调器拨号
将字符串发送到串行端口	如何：将字符串发送到串行端口
从串行端口接收字符串	如何：从串行端口接收字符串

可用性（按项目类型）

项目类型	可用
Windows 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	否
Windows 服务	是
网站	否

另请参阅

• SerialPortNames
• Parity
• StopBits
• SerialPort
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中使用连接到串行端口的调制解调器拨号
• 如何：在 Visual Basic 中将字符串发送到串行端口
• 如何：在 Visual Basic 中从串行端口接收字符串
• Using 语句 (Visual Basic)

OpenSerialPort(String, Int32, Parity, Int32)

创建并打开一个 SerialPort 对象。

public:
 System::IO::Ports::SerialPort ^ OpenSerialPort(System::String ^ portName, int baudRate, System::IO::Ports::Parity parity, int dataBits);

public System.IO.Ports.SerialPort OpenSerialPort (string portName, int baudRate, System.IO.Ports.Parity parity, int dataBits);

member this.OpenSerialPort : string * int * System.IO.Ports.Parity * int -> System.IO.Ports.SerialPort

Public Function OpenSerialPort (portName As String, baudRate As Integer, parity As Parity, dataBits As Integer) As SerialPort

参数

portName

String

String. 必需。 要打开的端口的名称。

baudRate

Int32

Integer. 端口的波特率。

parity

Parity

Parity. 端口的奇偶校验。

dataBits

Int32

Integer. 端口的数据位设置。

返回

SerialPort

一个打开的 SerialPort 对象，用提供的参数配置。

例外

ArgumentNullException

portName 为 Nothing 或空字符串。

ArgumentException

dataBits 小于或等于零。

InvalidEnumArgumentException

parity 不是 Parity 枚举值之一。

示例

此示例介绍如何将字符串发送到计算机的 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

有关详细信息，请参阅 如何：将字符串发送到串行端口。

注解

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

代码在使用 完 对象后，应将其关闭 SerialPort 。 可以使用 方法显式关闭对象，也可以使用 CloseUsing 语句隐式关闭对象。 有关详细信息，请参阅本主题中的示例。

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

功能	查看
拨打连接到串行端口的调制解调器	如何：使用连接到串行端口的调制解调器拨号
将字符串发送到串行端口	如何：将字符串发送到串行端口
从串行端口接收字符串	如何：从串行端口接收字符串

可用性（按项目类型）

项目类型	可用
Windows 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	否
Windows 服务	是
网站	否

另请参阅

• SerialPortNames
• Parity
• StopBits
• SerialPort
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中使用连接到串行端口的调制解调器拨号
• 如何：在 Visual Basic 中将字符串发送到串行端口
• 如何：在 Visual Basic 中从串行端口接收字符串
• Using 语句 (Visual Basic)

OpenSerialPort(String, Int32, Parity, Int32, StopBits)

创建并打开一个 SerialPort 对象。

public:
 System::IO::Ports::SerialPort ^ OpenSerialPort(System::String ^ portName, int baudRate, System::IO::Ports::Parity parity, int dataBits, System::IO::Ports::StopBits stopBits);

public System.IO.Ports.SerialPort OpenSerialPort (string portName, int baudRate, System.IO.Ports.Parity parity, int dataBits, System.IO.Ports.StopBits stopBits);

member this.OpenSerialPort : string * int * System.IO.Ports.Parity * int * System.IO.Ports.StopBits -> System.IO.Ports.SerialPort

Public Function OpenSerialPort (portName As String, baudRate As Integer, parity As Parity, dataBits As Integer, stopBits As StopBits) As SerialPort

参数

portName

String

String. 必需。 要打开的端口的名称。

baudRate

Int32

Integer. 端口的波特率。

parity

Parity

Parity. 端口的奇偶校验。

dataBits

Int32

Integer. 端口的数据位设置。

stopBits

StopBits

StopBits. 端口的停止位设置。

返回

SerialPort

一个打开的 SerialPort 对象，用提供的参数配置。

例外

ArgumentNullException

portName 为 Nothing 或空字符串。

ArgumentException

dataBits 小于或等于零。

InvalidEnumArgumentException

stopBits 不是 StopBits 枚举值之一。

示例

此示例介绍如何将字符串发送到计算机的 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

有关详细信息，请参阅 如何：将字符串发送到串行端口。

注解

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

代码在使用 完 对象后，应将其关闭 SerialPort 。 可以使用 方法显式关闭对象，也可以使用 CloseUsing 语句隐式关闭对象。 有关详细信息，请参阅本主题中的示例。

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

功能	查看
拨打连接到串行端口的调制解调器	如何：使用连接到串行端口的调制解调器拨号
将字符串发送到串行端口	如何：将字符串发送到串行端口
从串行端口接收字符串	如何：从串行端口接收字符串

可用性（按项目类型）

项目类型	可用
Windows 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	否
Windows 服务	是
网站	否

另请参阅

• SerialPortNames
• Parity
• StopBits
• SerialPort
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中使用连接到串行端口的调制解调器拨号
• 如何：在 Visual Basic 中将字符串发送到串行端口
• 如何：在 Visual Basic 中从串行端口接收字符串
• Using 语句 (Visual Basic)