SerialPort.Write Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает данные в выходной буфер последовательного порта.
Перегрузки
| Имя | Описание |
|---|---|
| Write(String) |
Записывает указанную строку в последовательный порт. |
| Write(Byte[], Int32, Int32) |
Записывает указанное число байтов в последовательный порт с помощью данных из буфера. |
| Write(Char[], Int32, Int32) |
Записывает указанное число символов в последовательный порт с помощью данных из буфера. |
Write(String)
- Исходный код:
- SerialPort.cs
- Исходный код:
- SerialPort.cs
- Исходный код:
- SerialPort.cs
- Исходный код:
- SerialPort.cs
Записывает указанную строку в последовательный порт.
public:
void Write(System::String ^ text);public void Write(string text);member this.Write : string -> unitPublic Sub Write (text As String)Параметры
- text
- String
Строка выходных данных.
Исключения
Указанный порт не открыт.
text равно null.
Операция не завершилась до окончания периода ожидания.
Комментарии
Используйте этот метод, если вы хотите записать строку в виде выходных данных в последовательный порт.
Если в выходном буфере слишком много байтов и Handshake задано XOnXOff значение, SerialPort объект может вызвать TimeoutException некоторое время, пока устройство будет готово к приему дополнительных данных.
По умолчанию SerialPort используется ASCIIEncoding для кодирования символов. ASCIIEncoding кодирует все символы, превышающие 127, как (char)63 или "?". Для поддержки дополнительных символов в этом диапазоне задайте EncodingUTF8Encodingзначение , UTF32Encodingили UnicodeEncoding.
Применяется к
Write(Byte[], Int32, Int32)
- Исходный код:
- SerialPort.cs
- Исходный код:
- 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 -> unitPublic Sub Write (buffer As Byte(), offset As Integer, count As Integer)Параметры
- buffer
- Byte[]
Массив байтов, содержащий данные для записи в порт.
- offset
- Int32
Отсчитываемое от нуля смещение байтов в параметре buffer , с которого начинается копирование байтов в порт.
- count
- Int32
Количество байтов для записи.
Исключения
Передано buffernull.
Указанный порт не открыт.
offset Параметры count находятся вне допустимой области передаваемого buffer объекта.
offset Либо count меньше нуля.
offset плюс count больше длины buffer.
Операция не завершилась до окончания периода ожидания.
Комментарии
Используйте этот метод, если требуется записать в буфер байтов, чтобы создать выходные данные в последовательный порт.
Если в выходном буфере слишком много байтов и Handshake задано XOnXOff значение, SerialPort объект может вызвать TimeoutException некоторое время, пока устройство будет готово к приему дополнительных данных.
Применяется к
Write(Char[], Int32, Int32)
- Исходный код:
- SerialPort.cs
- Исходный код:
- 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 -> unitPublic Sub Write (buffer As Char(), offset As Integer, count As Integer)Параметры
- buffer
- Char[]
Массив символов, содержащий данные для записи в порт.
- offset
- Int32
Отсчитываемое от нуля смещение байтов в параметре buffer , с которого начинается копирование байтов в порт.
- count
- Int32
Число записываемых символов.
Исключения
Передано buffernull.
Указанный порт не открыт.
offset Параметры count находятся вне допустимой области передаваемого buffer объекта.
offset Либо count меньше нуля.
offset плюс count больше длины buffer.
Операция не завершилась до окончания периода ожидания.
Комментарии
Используйте этот метод, если требуется записать в буфер символов, чтобы создать выходные данные в последовательный порт.
Если в выходном буфере слишком много байтов и Handshake задано XOnXOff значение, SerialPort объект может вызвать TimeoutException некоторое время, пока устройство будет готово к приему дополнительных данных.
По умолчанию SerialPort используется ASCIIEncoding для кодирования символов. ASCIIEncoding кодирует все символы, превышающие 127, как (char)63 или "?". Для поддержки дополнительных символов в этом диапазоне задайте EncodingUTF8Encodingзначение , UTF32Encodingили UnicodeEncoding.
