Метод My.Computer.Ports.OpenSerialPort

Статья
11/05/2008

Обновлен: Ноябрь 2007

Создает и открывает объект 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

Параметры

portName
String. Обязательный параметр. Имя открываемого порта.
baudRate
Integer. Скорость порта (в бодах).
parity
Parity. Четность порта.
dataBits
Integer. Настройки битов данных порта.
stopBits
StopBits. Параметры стоповых битов порта.

Возвращаемое значение

Открытый объект SerialPort, настроенный с помощью предоставленных аргументов.

Исключения

Исключение может возникнуть при следующих условиях:

Аргумент portName является Nothing или пустой строкой (ArgumentNullException).
Аргумент baudRate или dataBits равен нулю или отрицателен (ArgumentException).
Тип аргумента parity не является значением перечисления Parity (InvalidEnumArgumentException).
Тип аргумента stopBits не является значением перечисления StopBits (InvalidEnumArgumentException).

Заметки

Метод My.Computer.Ports.OpenSerialPort создает и открывает объект SerialPort. Аргументы метода OpenSerialPort определяют параметры объекта SerialPort.

Код должен закрыть объект SerialPortпосле завершения работы с ним. Метод Close, позволяет закрыть объект явно, а оператор Using закрывает его неявно. Дополнительные сведения см. в примере, приведенном в этом разделе.

Задачи

В следующей таблице приведены примеры задач, в которых используется метод My.Computer.Ports.OpenSerialPort:

Чтобы	См.
Использовать модем, подключенный к последовательному порту	Практическое руководство. Дозвон при помощи модема, подключенного к последовательному порту компьютера, в Visual Basic
Отправить строку в последовательный порт	Практическое руководство. Отправка строк в последовательный порт в Visual Basic
Получить строки из последовательного порта	Практическое руководство. Получение строк из последовательных портов в Visual Basic

Пример

В этом примере описывается отправка строк в последовательный порт COM1.

Блок Using позволяет приложению закрыть последовательный порт, даже если генерируется исключение. Весь код, который управляет последовательным портом, должен находиться внутри этого блока, или внутри блока Try...Catch...Finally, в котором есть вызов метода Close.

Метод WriteLine позволяет отправить данные в последовательный порт.

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

Дополнительные сведения см. в разделе Практическое руководство. Отправка строк в последовательный порт в Visual Basic.

Требования

Пространство имен:Microsoft.VisualBasic.Devices

Класс:Ports

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта	Доступность
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Нет
Служба Windows	Да
Веб-узел	Нет