SerialPort.Write Método

Definición

Espacio de nombres:

System.IO.Ports

Ensamblado:

System.IO.Ports.dll

Paquete:

System.IO.Ports v8.0.0

Escribe datos en el búfer de salida del puerto serie.

Sobrecargas

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 utilizando los datos de un búfer.
Write(Char[], Int32, Int32)	Escribe un número especificado de caracteres en el puerto serie utilizando los datos de un búfer.

Write(String)

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 -> unit

Public Sub Write (text As String)

Parámetros

text

String

Cadena de salida.

Excepciones

InvalidOperationException

El puerto especificado no está abierto.

ArgumentNullException

text es null.

TimeoutException

La operación no se ha terminado antes de que transcurriera el 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 Encoding en UTF8Encoding, UTF32Encodingo UnicodeEncoding.

Write(Byte[], Int32, Int32)

Source:

SerialPort.cs

Escribe un número especificado de bytes en el puerto serie utilizando los 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 -> unit

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

Parámetros

buffer

Byte[]

Matriz de bytes que contiene los datos para escribir en el puerto.

offset

Int32

Desplazamiento en bytes de base cero del parámetro buffer donde comienzan a copiarse los datos para el puerto.

count

Int32

Número de bytes que se van a escribir.

Excepciones

ArgumentNullException

El valor de buffer pasado es null.

InvalidOperationException

El puerto especificado no está abierto.

ArgumentOutOfRangeException

Los parámetros offset o count están fuera de una región válida del buffer que se pasa. offset o count es menor que cero.

ArgumentException

La suma de offset y count es mayor que la longitud de buffer.

TimeoutException

La operación no se ha terminado antes de que transcurriera el 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.

Write(Char[], Int32, Int32)

Source:

SerialPort.cs

Escribe un número especificado de caracteres en el puerto serie utilizando los 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 -> unit

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

Parámetros

buffer

Char[]

Matriz de caracteres que contiene los datos para escribir en el puerto.

offset

Int32

Desplazamiento en bytes de base cero del parámetro buffer donde comienzan a copiarse los datos para el puerto.

count

Int32

Número de caracteres que se van a escribir.

Excepciones

ArgumentNullException

El valor de buffer pasado es null.

InvalidOperationException

El puerto especificado no está abierto.

ArgumentOutOfRangeException

Los parámetros offset o count están fuera de una región válida del buffer que se pasa. offset o count es menor que cero.

ArgumentException

La suma de offset y count es mayor que la longitud de buffer.

TimeoutException

La operación no se ha terminado antes de que transcurriera el 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 Encoding en UTF8Encoding, UTF32Encodingo UnicodeEncoding.