Método My.Computer.Ports.OpenSerialPort

Artigo
08/25/2010

Cria e abre um SerialPort objeto.

' 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

Parâmetros

portName
String.Obrigatório.Nome da porta para em em aberto.
baudRate
Integer.Taxa de transmissão da porta.
parity
Parity.Paridade da porta.
dataBits
Integer.bit de dados de configuração da porta.
stopBits
StopBits.Configuração de bit de parada da porta.

Valor de retorno

Uma abertura SerialPort objeto, configurado com os argumentos fornecidos.

Exceções

As condições a seguir podem causar uma exceção:

The portName o argumento é Nothing ou um (seqüência de caracteres vaziaArgumentNullException).
The baudRate ou dataBits argumento for zero ou negativos ()ArgumentException).
The parity tipo de argumento não é um do Parity () valores de enumeraçãoInvalidEnumArgumentException).
The stopBits tipo de argumento não é um do StopBits () valores de enumeraçãoInvalidEnumArgumentException).

Comentários

The My.Computer.Ports.OpenSerialPort método cria e abre um SerialPort objeto. Os argumentos para o OpenSerialPort método determinar as configurações dos SerialPort objeto.

Seu código deve fechar o SerialPort objeto quando ele for concluído usando o objeto. Você pode usar o Close método para fechar o objeto explicitamente ou o Using demonstrativo para fechá-la implicitamente. Consulte o exemplo neste tópico para obter mais informações.

Tarefas

A tabela a seguir lista exemplos de tarefas envolvendo o método My.Computer.Ports.OpenSerialPort.

Para	Consulte
Disque um modem conectado a uma porta serial	Como: Discar modems anexados a portas seriais no Visual Basic
Enviar uma seqüência de caracteres para a porta serial	Como: Enviar seqüências para portas seriais no Visual Basic
Recebe as sequências de caracteres de uma porta serial	Como: Receber Strings de Serial Ports in Visual Basic

Exemplo

Este exemplo descreve como enviar sequências de caracteres para a porta serial COM1 do computador.

O bloco Using permite que ao aplicativo feche a porta serial mesmo que se gere uma exceção.Todo o código que manipula a porta serial deve aparecer dentro deste bloco, ou em um bloco Try...Catch...Finally com uma chamada para usar o método Close.

O método WriteLine envia os dados para a porta serial.

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

Para obter mais informações, consulte Como: Enviar seqüências para portas seriais no Visual Basic.

Requisitos

Namespace:Microsoft.VisualBasic.Devices

Classe:Ports

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

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Não
Serviço do Windows	Sim
Site	Não