My.Computer.Ports.OpenSerialPort (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

Crea y abre un objeto 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

Parámetros

portName
String. Requerido. Nombre del puerto que se va a abrir.
baudRate
Integer. Velocidad en baudios del puerto.
parity
Parity. Paridad del puerto.
dataBits
Integer. Configuración de bit de datos del puerto.
stopBits
StopBits. Configuración de bit de parada del puerto.

Valor devuelto

Objeto SerialPort abierto, configurado con los argumentos proporcionados.

Excepciones

Las condiciones siguientes pueden provocar una excepción:

El argumento portName es Nothing o una cadena vacía (ArgumentNullException).
El argumento baudRate o dataBits es cero o negativo (ArgumentException).
El tipo del argumento parity no se corresponde con ninguno de los valores de la enumeración Parity (InvalidEnumArgumentException).
El tipo del argumento stopBits no se corresponde con ninguno de los valores de la enumeración StopBits (InvalidEnumArgumentException).

Comentarios

El método My.Computer.Ports.OpenSerialPort crea y abre un objeto SerialPort. Los argumentos para el método OpenSerialPort determinan la configuración del objeto SerialPort.

El código debería cerrar el objeto SerialPort cuando se termina de utilizar el objeto. Puede utilizar el método Close para cerrar explícitamente el objeto o la instrucción Using para cerrarlo implícitamente. Vea el ejemplo en este tema para obtener más información.

Tareas

En la tabla siguiente se muestran ejemplos de tareas en las que interviene el método My.Computer.Ports.OpenSerialPort.

Para	Vea
Marcar un módem asociado a un puerto serie	Cómo: Marcar a través de módems conectados a puertos serie en Visual Basic
Enviar una cadena al puerto serie	Cómo: Enviar cadenas a puertos serie en Visual Basic
Recibir las cadenas de un puerto serie	Cómo: Recibir cadenas de puertos serie en Visual Basic

Ejemplo

En este ejemplo se describe cómo enviar cadenas al puerto serie COM1 del equipo.

El bloque Using permite a la aplicación cerrar el puerto serie aun cuando se genere una excepción. Todo el código que utiliza el puerto serie debe aparecer dentro de este bloque o dentro de un bloque Try...Catch...Finally con una llamada para utilizar el método Close.

El método WriteLine envía los datos al puerto serie.

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 obtener más información, vea Cómo: Enviar cadenas a puertos serie en Visual Basic.

Requisitos

Espacio de nombres:Microsoft.VisualBasic.Devices

Clase:Ports

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	Sí
Aplicación de consola	Sí
Biblioteca de controles de Windows	Sí
Biblioteca de controles Web	No
Servicio de Windows	Sí
Sitio Web	No