Поделиться через


SerialPort.Write Метод

Определение

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

Перегрузки

Write(String)

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

Write(Byte[], Int32, Int32)

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

Write(Char[], Int32, Int32)

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

Write(String)

Исходный код:
SerialPort.cs
Исходный код:
SerialPort.cs
Исходный код:
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

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

Исключения

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

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

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

Комментарии

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

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

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

Применяется к

Write(Byte[], Int32, Int32)

Исходный код:
SerialPort.cs
Исходный код:
SerialPort.cs
Исходный код:
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

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

Исключения

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

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

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

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

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

Комментарии

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

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

Применяется к

Write(Char[], Int32, Int32)

Исходный код:
SerialPort.cs
Исходный код:
SerialPort.cs
Исходный код:
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

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

Исключения

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

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

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

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

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

Комментарии

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

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

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

Применяется к