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. 連接埠的傳輸速率 (Baud Rate)。

傳回

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. 連接埠的傳輸速率 (Baud Rate)。

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 物件。 您可以使用 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, 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. 連接埠的傳輸速率 (Baud Rate)。

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 物件。 您可以使用 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, 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. 連接埠的傳輸速率 (Baud Rate)。

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 應該關閉 物件。 您可以使用 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)