SerialPort.Write Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Escribe datos en el búfer de salida del puerto serie.
Sobrecargas
| Nombre | Description |
|---|---|
| Write(String) |
Escribe la cadena especificada en el puerto serie. |
| Write(Byte[], Int32, Int32) |
Escribe un número especificado de bytes en el puerto serie mediante datos de un búfer. |
| Write(Char[], Int32, Int32) |
Escribe un número especificado de caracteres en el puerto serie mediante datos de un búfer. |
Write(String)
- Source:
- SerialPort.cs
- Source:
- SerialPort.cs
- Source:
- SerialPort.cs
- Source:
- SerialPort.cs
Escribe la cadena especificada en el puerto serie.
public:
void Write(System::String ^ text);public void Write(string text);member this.Write : string -> unitPublic Sub Write (text As String)Parámetros
- text
- String
Cadena para la salida.
Excepciones
El puerto especificado no está abierto.
text es null.
La operación no se completó antes de que finalice el período de tiempo de espera.
Comentarios
Use este método cuando desee escribir una cadena como salida en un puerto serie.
Si hay demasiados bytes en el búfer de salida y Handshake se establece XOnXOff en , el SerialPort objeto puede generar un TimeoutException tiempo mientras espera a que el dispositivo esté listo para aceptar más datos.
De forma predeterminada, SerialPort usa ASCIIEncoding para codificar los caracteres. ASCIIEncoding codifica todos los caracteres mayores que 127 como (char)63 o "?". Para admitir caracteres adicionales en ese intervalo, establezca en EncodingUTF8Encoding, UTF32Encodingo UnicodeEncoding.
Se aplica a
Write(Byte[], Int32, Int32)
- Source:
- SerialPort.cs
- Source:
- SerialPort.cs
- Source:
- SerialPort.cs
- Source:
- SerialPort.cs
Escribe un número especificado de bytes en el puerto serie mediante datos de un búfer.
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)Parámetros
- buffer
- Byte[]
Matriz de bytes que contiene los datos que se van a escribir en el puerto.
- offset
- Int32
Desplazamiento de bytes de base cero en el parámetro en el buffer que se van a empezar a copiar bytes en el puerto.
- count
- Int32
Número de bytes que se van a escribir.
Excepciones
El buffer objeto pasado es null.
El puerto especificado no está abierto.
Los offset parámetros o count están fuera de una región válida de la buffer que se pasa. O es offset menor que count cero.
offsetplus count es mayor que la longitud de .buffer
La operación no se completó antes de que finalice el período de tiempo de espera.
Comentarios
Use este método cuando desee escribir en un búfer de bytes para crear la salida en un puerto serie.
Si hay demasiados bytes en el búfer de salida y Handshake se establece XOnXOff en , el SerialPort objeto puede generar un TimeoutException tiempo mientras espera a que el dispositivo esté listo para aceptar más datos.
Se aplica a
Write(Char[], Int32, Int32)
- Source:
- SerialPort.cs
- Source:
- SerialPort.cs
- Source:
- SerialPort.cs
- Source:
- SerialPort.cs
Escribe un número especificado de caracteres en el puerto serie mediante datos de un búfer.
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)Parámetros
- buffer
- Char[]
Matriz de caracteres que contiene los datos que se van a escribir en el puerto.
- offset
- Int32
Desplazamiento de bytes de base cero en el parámetro en el buffer que se van a empezar a copiar bytes en el puerto.
- count
- Int32
Número de caracteres que se van a escribir.
Excepciones
El buffer objeto pasado es null.
El puerto especificado no está abierto.
Los offset parámetros o count están fuera de una región válida de la buffer que se pasa. O es offset menor que count cero.
offsetplus count es mayor que la longitud de .buffer
La operación no se completó antes de que finalice el período de tiempo de espera.
Comentarios
Use este método cuando desee escribir en un búfer de caracteres para crear la salida en un puerto serie.
Si hay demasiados bytes en el búfer de salida y Handshake se establece XOnXOff en , el SerialPort objeto puede generar un TimeoutException tiempo mientras espera a que el dispositivo esté listo para aceptar más datos.
De forma predeterminada, SerialPort usa ASCIIEncoding para codificar los caracteres. ASCIIEncoding codifica todos los caracteres mayores que 127 como (char)63 o "?". Para admitir caracteres adicionales en ese intervalo, establezca en EncodingUTF8Encoding, UTF32Encodingo UnicodeEncoding.
