SerialPort.Write Метод

Определение

Пространство имен:

System.IO.Ports

Сборка:

System.IO.Ports.dll

Пакет:

System.IO.Ports v8.0.0

Записывает данные в выходной буфер последовательного порта.

Перегрузки

Write(String)	Записывает указанную строку в последовательный порт.
Write(Byte[], Int32, Int32)	Записывает указанное число байтов в последовательный порт, используя данные из буфера.
Write(Char[], Int32, Int32)	Записывает указанное число символов в последовательный порт, используя данные из буфера.

Write(String)

Исходный код:

SerialPort.cs

Записывает указанную строку в последовательный порт.

public:
 void Write(System::String ^ text);

public void Write (string text);

member this.Write : string -> unit

Public Sub Write (text As String)

Параметры

text

String

Строка для вывода.

Исключения

InvalidOperationException

Указанный порт не открыт.

ArgumentNullException

text имеет значение null.

TimeoutException

Операция не была завершена до истечения срока ожидания.

Комментарии

Используйте этот метод, если требуется записать строку в качестве выходных данных в последовательный порт.

Если в выходном буфере слишком много байтов, HandshakeXOnXOff то SerialPort объект может вызвать TimeoutException некоторое время ожидания, пока устройство будет готово принять дополнительные данные.

По умолчанию SerialPort использует ASCIIEncoding для кодирования символов. ASCIIEncoding кодирует все символы больше 127 как (char)63 или "?". Для поддержки дополнительных символов в этом диапазоне задайте значение EncodingUTF8Encoding, UTF32Encodingили UnicodeEncoding.

Write(Byte[], Int32, Int32)

Исходный код:

SerialPort.cs

Записывает указанное число байтов в последовательный порт, используя данные из буфера.

public:
 void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public void Write (byte[] buffer, int offset, int count);

member this.Write : byte[] * int * int -> unit

Public Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Параметры

buffer

Byte[]

Массив байтов, данные из которого записываются в порт.

offset

Int32

Отсчитываемое от нуля смещение в массиве buffer (в байтах), с которого начинается копирование байтов в порт.

count

Int32

Количество записываемых байтов.

Исключения

ArgumentNullException

В качестве buffer передано null.

InvalidOperationException

Указанный порт не открыт.

ArgumentOutOfRangeException

Значение параметра offset или count выходит за пределы указанного массива buffer. Значение параметра offset или count меньше нуля.

ArgumentException

offset плюс count превышает длину массива buffer.

TimeoutException

Операция не была завершена до истечения срока ожидания.

Комментарии

Используйте этот метод, если требуется выполнить запись в байтовый буфер для создания выходных данных в последовательный порт.

Если в выходном буфере слишком много байтов, HandshakeXOnXOff то SerialPort объект может вызвать TimeoutException некоторое время ожидания, пока устройство будет готово принять дополнительные данные.

Write(Char[], Int32, Int32)

Исходный код:

SerialPort.cs

Записывает указанное число символов в последовательный порт, используя данные из буфера.

public:
 void Write(cli::array <char> ^ buffer, int offset, int count);

public void Write (char[] buffer, int offset, int count);

member this.Write : char[] * int * int -> unit

Public Sub Write (buffer As Char(), offset As Integer, count As Integer)

Параметры

buffer

Char[]

Массив символов, данные из которого записываются в порт.

offset

Int32

Отсчитываемое от нуля смещение в массиве buffer (в байтах), с которого начинается копирование байтов в порт.

count

Int32

Количество символов для записи.

Исключения

ArgumentNullException

В качестве buffer передано null.

InvalidOperationException

Указанный порт не открыт.

ArgumentOutOfRangeException

Значение параметра offset или count выходит за пределы указанного массива buffer. Значение параметра offset или count меньше нуля.

ArgumentException

offset плюс count превышает длину массива buffer.

TimeoutException

Операция не была завершена до истечения срока ожидания.

Комментарии

Используйте этот метод, если требуется выполнить запись в символьный буфер для создания выходных данных в последовательный порт.

Если в выходном буфере слишком много байтов, HandshakeXOnXOff то SerialPort объект может вызвать TimeoutException некоторое время ожидания, пока устройство будет готово принять дополнительные данные.

По умолчанию SerialPort использует ASCIIEncoding для кодирования символов. ASCIIEncoding кодирует все символы больше 127 как (char)63 или "?". Для поддержки дополнительных символов в этом диапазоне задайте значение EncodingUTF8Encoding, UTF32Encodingили UnicodeEncoding.