My.Computer.Ports.OpenSerialPort 方法

發行項
08/21/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 方法的工作範例。

若要	請參閱
撥接與序列埠連接的數據機	HOW TO：在 Visual Basic 中撥接與序列埠連接的數據機
傳送字串給序列埠	HOW TO：在 Visual Basic 中將字串傳送至序列埠
接收來自序列埠的字串	HOW TO：在 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

如需詳細資訊，請參閱 HOW TO：在 Visual Basic 中將字串傳送至序列埠。