Metodo My.Computer.Ports.OpenSerialPort

Articolo
09/12/2008

Aggiornamento: novembre 2007

Crea e apre un oggetto 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

Parametri

portName
String. Obbligatorio. Nome della porta da aprire.
baudRate
Integer. Velocità in baud della porta.
parity
Parity. Parità della porta.
dataBits
Integer. Impostazione dei bit di dati della porta.
stopBits
StopBits. Impostazione dei bit di stop della porta.

Valore restituito

Oggetto SerialPort aperto, configurato con gli argomenti forniti.

Eccezioni

Le seguenti condizioni possono causare un'eccezione:

L'argomento portName è Nothing o una stringa vuota (ArgumentNullException).
Il valore dell'argomento baudRate o dataBits è zero o negativo (ArgumentException).
Il tipo di argomento parity non è uno dei valori di enumerazione Parity (InvalidEnumArgumentException).
Il tipo di argomento stopBits non è uno dei valori di enumerazione StopBits (InvalidEnumArgumentException).

Note

Il metodo My.Computer.Ports.OpenSerialPort consente di creare e aprire un oggetto SerialPort. Gli argomenti del metodo OpenSerialPort determinano le impostazioni dell'oggetto SerialPort.

Dopo aver utilizzato l'oggetto, è necessario che il codice chiuda l'oggetto SerialPort. A questo scopo, utilizzare il metodo Close per chiudere l'oggetto in modo esplicito oppure l'istruzione Using per chiuderlo in modo implicito. Per ulteriori informazioni, vedere l'esempio in questo argomento.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.Ports.OpenSerialPort.

Per	Vedere
Comporre numeri con un modem collegato a una porta seriale	Procedura: comporre numeri con modem collegati a porte seriali in Visual Basic
Inviare una stringa a una porta seriale	Procedura: inviare stringhe a porte seriali in Visual Basic
Ricevere stringhe da una porta seriale	Procedura: ricevere stringhe da porte seriali in Visual Basic

Esempio

Nell'esempio viene descritto come inviare stringhe alla porta seriale COM1 del computer.

Il blocco Using consente all'applicazione di chiudere la porta seriale anche se viene generata un'eccezione. Tutto il codice relativo alla porta seriale deve essere contenuto all'interno di questo blocco o di un blocco Try...Catch...Finally tramite una chiamata all'uso del metodo Close.

Il metodo WriteLine invia i dati alla porta seriale.

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

Per ulteriori informazioni, vedere Procedura: inviare stringhe a porte seriali in Visual Basic.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.Devices

Classe:Ports

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilità per tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione console	Sì
Libreria di controlli Windows	Sì
Libreria di controlli Web	No
Servizio Windows	Sì
Sito Web	No