Partager via


My.Computer.Ports.OpenSerialPort, méthode

Mise à jour : novembre 2007

Crée et ouvre un objet 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

Paramètres

  • portName
    String. Requis. Nom du port à ouvrir.

  • baudRate
    Integer. Vitesse en bauds du port.

  • parity
    Parity. Parité du port.

  • dataBits
    Integer. Paramètre de bit des données du port.

  • stopBits
    StopBits. Paramètre de bit d'arrêt du port.

Valeur de retour

Objet SerialPort ouvert, configuré avec les arguments fournis.

Exceptions

Les conditions ci-dessous peuvent générer une exception :

Notes

La méthode My.Computer.Ports.OpenSerialPort crée et ouvre un objet SerialPort. Les arguments de la méthode OpenSerialPort déterminent les paramètres de l'objet SerialPort.

Votre code doit fermer l'objet SerialPort lorsqu'il a fini de l'utiliser. Vous pouvez utiliser la méthode Close pour fermer l'objet explicitement ou l'instruction Using pour le fermer implicitement. Pour plus d'informations, consultez l'exemple de cette rubrique.

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la méthode My.Computer.Ports.OpenSerialPort.

Pour

Reportez-vous à

Utiliser un modem rattaché à un port série

Comment : passer des appels avec des modems attachés aux ports série dans Visual Basic

Envoyer une chaîne à un port série

Comment : envoyer des chaînes aux ports série dans Visual Basic

Recevoir des chaînes d'un port série

Comment : recevoir des chaînes des ports série dans Visual Basic

Exemple

Cet exemple montre comment envoyer des chaînes au port série COM1 de l'ordinateur.

Le bloc Using permet à l'application de fermer le port série même s'il génère une exception. Tout le code qui manipule le port série doit apparaître dans ce bloc ou dans un bloc Try...Catch...Finally avec un appel pour utiliser la méthode Close.

La méthode WriteLine envoie les données au port série.

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

Pour plus d'informations, consultez Comment : envoyer des chaînes aux ports série dans Visual Basic.

Configuration requise

Espace de noms :Microsoft.VisualBasic.Devices

Classe :Ports

Assembly : bibliothèque Runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet

Disponible

Application Windows

Oui

Bibliothèque de classes

Oui

Application console

Oui

Bibliothèque de contrôles Windows

Oui

Bibliothèque de contrôles Web

Non

Service Windows

Oui

Site Web

Non

Autorisations

Aucune autorisation n'est requise.

Voir aussi

Tâches

Comment : passer des appels avec des modems attachés aux ports série dans Visual Basic

Comment : envoyer des chaînes aux ports série dans Visual Basic

Comment : recevoir des chaînes des ports série dans Visual Basic

Référence

My.Computer.Ports, objet

My.Computer.Ports.SerialPortNames, propriété

System.IO.Ports.Parity

System.IO.Ports.StopBits

System.IO.Ports.SerialPort

Ports.OpenSerialPort

Using, instruction (Visual Basic)