My.Computer.Ports.OpenSerialPort-Methode

Artikel
08/20/2008

Aktualisiert: November 2007

Erstellt und öffnet ein SerialPort-Objekt.

' 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

Parameter

portName
String. Erforderlich. Name des zu öffnenden Anschlusses.
baudRate
Integer. Baudrate des Anschlusses.
parity
Parity. Parität des Anschlusses.
dataBits
Integer. Datenbiteinstellung des Anschlusses.
stopBits
StopBits. Stoppbiteinstellung des Anschlusses.

Rückgabewert

Ein geöffnetes SerialPort-Objekt, das mit den angegebenen Argumenten konfiguriert ist.

Ausnahmen

Die folgenden Bedingungen können eine Ausnahme verursachen:

Das portName-Argument ist Nothing oder eine leere Zeichenfolge (ArgumentNullException).
Das baudRate-Argument oder das dataBits-Argument ist 0 (null) oder ein negativer Wert (ArgumentException).
Der parity-Argumenttyp ist keiner der Parity-Enumerationswerte (InvalidEnumArgumentException).
Der stopBits-Argumenttyp ist keiner der StopBits-Enumerationswerte (InvalidEnumArgumentException).

Hinweise

Die My.Computer.Ports.OpenSerialPort-Methode erstellt und öffnet ein SerialPort-Objekt. Die Argumente für die OpenSerialPort-Methode bestimmen die Einstellungen des SerialPort-Objekts.

Im Code sollte das SerialPort-Objekt geschlossen werden, wenn das Objekt nicht mehr verwendet wird. Mit der Close-Methode können Sie das Objekt explizit und mit der Using-Anweisung implizit schließen. Weitere Informationen finden Sie im Beispiel in diesem Thema.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.Ports.OpenSerialPort-Methode aufgeführt.

Zweck	Weitere Informationen finden Sie unter
Wählen mit einem an einen seriellen Anschluss angefügten Modem	Gewusst wie: Wählen mit Modems an seriellen Anschlüssen in Visual Basic
Senden einer Zeichenfolge an einen seriellen Anschluss	Gewusst wie: Senden von Zeichenfolgen zu seriellen Anschlüssen in Visual Basic
Empfangen von Zeichenfolgen von einem seriellen Anschluss	Gewusst wie: Empfangen von Zeichenfolgen von seriellen Anschlüssen in Visual Basic

Beispiel

In diesem Beispiel wird das Senden von Zeichenfolgen an den seriellen COM1-Anschluss des Computers veranschaulicht.

Der Using-Block ermöglicht der Anwendung, den seriellen Anschluss auch dann zu schließen, wenn dies eine Ausnahme generiert. Für einen Aufruf der Close-Methode sollte Code, der den seriellen Anschluss konfiguriert, vollständig in diesen Block oder in einen Try...Catch...Finally-Block eingeschlossen werden.

Die WriteLine-Methode sendet die Daten an den seriellen Anschluss.

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

Weitere Informationen finden Sie unter Gewusst wie: Senden von Zeichenfolgen zu seriellen Anschlüssen in Visual Basic.